[TIL] 🛠️일정관리 필수 설계/트러블 슈팅

API 설계

🔗 📄 Schedule Project API 문서

ERD 설계

DB 생성

설정

application.properties

spring.datasource.url=jdbc:mysql://localhost:3306/database_name
spring.datasource.username=name
spring.datasource.password=password
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.sql.init.schema-locations=classpath:schema_file
spring.sql.init.mode=always

스키마

CREATE DATABASE IF NOT EXISTS schedule;
USE schedule;
CREATE TABLE IF NOT EXISTS event
(
    id           BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '고유 식별자',
    task         VARCHAR(50),
    created_time TIMESTAMP   NOT NULL COMMENT '생성 날짜',
    edited_time  TIMESTAMP   NOT NULL COMMENT '수정된 날짜',
    owner        VARCHAR(25) NOT NULL COMMENT '작성자명',
    password     VARCHAR(25) NOT NULL COMMENT '비밀번호'
);

트러블 슈팅

DB 구성

📌 문제

⛔ 문제

스프링부트 앱 실행 시, 아래와 같은 에러 메세지 발생하며 실행이 되지 않음.

org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'dataSourceScriptDatabaseInitializer' defined in class path resource [org/springframework/boot/autoconfigure/sql/init/DataSourceInitializationConfiguration.class]: Failed to execute SQL script statement #2 of class path resource [schedule.sql]: CREATE TABLE event ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '고유 식별자', task VARCHAR(50), created_time TIMESTAMP NOT NULL COMMENT '생성 날짜', edited_time TIMESTAMP NOT NULL COMMENT '수정된 날짜', owner VARCHAR(25) NOT NULL COMMENT '작성자명', password VARCHAR(25) NOT NULL COMMENT '비밀번호' )
...
Caused by: java.sql.SQLSyntaxErrorException: Table 'event' already exists

---

❓ 원인

기존 SQL 문

USE schedule;
CREATE TABLE event
(
    id           BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '고유 식별자',
    task         VARCHAR(50),
    created_time TIMESTAMP   NOT NULL COMMENT '생성 날짜',
    edited_time  TIMESTAMP   NOT NULL COMMENT '수정된 날짜',
    owner        VARCHAR(25) NOT NULL COMMENT '작성자명',
    password     VARCHAR(25) NOT NULL COMMENT '비밀번호'
);

Caused by: java.sql.SQLSyntaxErrorException: Table 'event' already exists

에러 메세지 분석 결과, 이미 존재하는 테이블을 만들려고 해서 문제 발생

• 기존에는 main/resource 아래에 스키마 파일을 위치하도록 했음.

  • 지시 사항대로 스키마 sql 파일을 최상위 디렉토리로 경로 옮겨도 동일
  • 에러 메세지 살펴보니 경로 문제가 아니었음을 파악

• 이미 존재하는 테이블을 새로 생성하려고 해서 문제가 발생함.

• App 실행 이전에 DB 연결 설정하면서 테이블이 생성된 것이 원인으로 파악

  ---

❗ 해결

• CREATE TABLE과 CREATE DATABASE 앞에 IF NOT EXISTS 를 추가하여 해결
  
  
  

프로그램 실행

📌 파라미터 값 전달

⛔ 문제
API 요청 테스트 중 아래와 같은 에러 메세지와 함께 400 BAD REQUEST 상태 코드를 반환 받음.

2025-03-25T15:25:17.962+09:00  WARN 17340 --- [Schedule] [nio-8080-exec-2] .w.s.m.s.DefaultHandlerExceptionResolver : Resolved [org.springframework.web.HttpMediaTypeNotAcceptableException: No acceptable representation]

---

❓ 원인

• 요청 처리 후 응답 시, ResponseDTO➡️json 변환 과정에서(json 파싱) 값 세팅이 되지 않음.
• ResponseDTO에 @Getter 어노테이션이 없어 값을 불러올 수 없었음.

---

❗ 해결

• @Getter 어노테이션을 추가하여 해결
  
  

💭 그 외

• Postman으로 API 테스트를 하였으나 문제 발생 지점을 정확하게 파악하기 위해 추가적인 테스트 코드나 에러 핸들러가 필요하다고 느낌.
• 그러나 시간이 없어 System.out.println으로 수동 테스트를 진행, 비효율적인 테스트 방식이라고 판단.
  
  
• JUnit은 HTTP 요청이 아닌 메소드 호출로 테스팅이 이루어지기 때문에 API 테스트에는 적절하지 않을 수 있음.
• MockMvc를 활용하면 Postman처럼 컨트롤러 단부터 실제 HTTP 요청을 시뮬레이션하여 테스팅이 가능하다고 함. 이에 대해 추가 학습할 계획.

📌 동일 HTTP 메소드/엔드포인트 API 충돌

⛔ 문제
API 요청 테스트 중 아래와 같은 에러 메세지와 함께 컨트롤러 호출에 실패.

org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'requestMappingHandlerMapping' defined in class path resource [org/springframework/boot/autoconfigure/web/servlet/WebMvcAutoConfiguration$EnableWebMvcConfiguration.class]: Ambiguous mapping. Cannot map 'eventController' method 
org.example.schedule.controller.EventController#findAllEvents()
to {GET [/events]}: There is already 'eventController' bean method
org.example.schedule.controller.EventController#findAllEventsByOwnerOrEditedTime(String, Timestamp, Timestamp) mapped.
...
Caused by: java.lang.IllegalStateException: Ambiguous mapping. Cannot map 'eventController' method 
org.example.schedule.controller.EventController#findAllEvents()
to {GET [/events]}: There is already 'eventController' bean method
org.example.schedule.controller.EventController#findAllEventsByOwnerOrEditedTime(String, Timestamp, Timestamp) mapped.

---

❓ 원인

Caused by: java.lang.IllegalStateException: Ambiguous mapping. Cannot map 'eventController' method 

• 중복된 맵핑(Ambiguous mapping)으로 인해 컨트롤러가 어떤 메소드를 맵핑할 지 결정할 수 없음.
  
  

  // 전체 조회
  @GetMapping
  List<EventResponseDTO> findAllEvents() {
    return eventService.findAllEvents();
  }

  // 조건 일치 일정들 조회 (수정 날짜, 작성자명)
  @GetMapping
  List<EventResponseDTO> findAllEventsByOwnerOrEditedTime(
      @RequestParam String owner,
      @RequestParam Timestamp startDate,
      @RequestParam Timestamp endDate) {
    return eventService.findAllEventsByOwnerOrEditedTime(owner, startDate, endDate);
  }

• 에러가 발생한 부분의 코드를 살펴보면 동일 경로, 동일 HTTP 메소드(GET 요청)이지만 파라미터가 다름.
• 그러나 Spring MVC는 HTTP 요청 매핑 시 경로와 HTTP 메소드(GET, POST etc.)으로 메소드 맵핑을 구분한다.
• 즉, 파라미터 유무는 메소드 맵핑의 기준이 되지 않는다.

---

❗ 해결

• 엔드포인트(경로)를 다르게 하여 메소드 맵핑이 정상적으로 처리되도록 함.
  
  
  

📌 API - 날짜 파라미터 처리

⛔ 문제

• API 요청 테스트 중 아래와 같은 메세지와 함께 Timestamp startDate 파라미터 처리에 실패함.

.MethodArgumentTypeMismatchException: Method parameter 'startDate': Failed to convert value of type 'java.lang.String' to required type 'java.sql.Timestamp'; Failed to convert from type [java.lang.String] to type [@org.springframework.web.bind.annotation.RequestParam java.sql.Timestamp] for value [2025-03-21T00:00:00]]

---

❓ 원인

Failed to convert from type [java.lang.String] to type [@org.springframework.web.bind.annotation.RequestParam java.sql.Timestamp]

• String 에서 Timestamp 타입 변환에 실패했음.
• 2025-03-03 과 같이 날짜 포맷에 맞춰서 요청을 보냈음에도 불구하고 변환이 이루어지지 않음.

---

❗ 해결

1차 시도

• 날짜 파라미터에 @DateTimeFormat 어노테이션을 붙여 날짜 포맷으로 인식되도록 함.
• 그러나 여전히 요청 파라미터가 String으로 인식 됨.

2차

• Timestamp 타입은 @DateTimeFormat 어노테이션을 사용해도 인식이 안된다.
• 따라서 @DateTimeFormat 어노테이션이 지원하는 타입들 (Date, LocalTime, LocalDateTime) 중에서LocalDateTime을 사용하도록 변경하여 문제 해결.
  
  
  

DTO-Entity 변환 담당 레이어

• 강의에서는 레포지토리에서 하긴했느데.. 레포지토리가 그런 일도 해야할지?
• 가능한 서비스레이어에서 처리하고 싶은데
• 구현도 클래스 내부에 toEntity 식으로 구현할지 아니면 서비스 레이어에서 구현해둘지
  https://velog.io/@jsb100800/Spring-boot-DTO-Entity-%EA%B0%84-%EB%B3%80%ED%99%98-%EC%96%B4%EB%8A%90-Layer%EC%97%90%EC%84%9C-%ED%95%98%EB%8A%94%EA%B2%8C-%EC%A2%8B%EC%9D%84%EA%B9%8C#-service-layer%EC%97%90%EC%84%9C-dto-entity-%EB%B3%80%ED%99%98-%EC%9E%91%EC%97%85
  https://velog.io/@smc2315/DTO-Entity-%EB%B3%80%ED%99%98-%EB%A9%94%EC%84%9C%EB%93%9C-%EA%B5%AC%ED%98%84-%EC%9C%84%EC%B9%98%EB%8A%94-%EC%96%B4%EB%94%94%EA%B0%80-%EC%A2%8B%EC%9D%84%EA%B9%8C#%EB%8B%A8%EC%A0%90-1

📌 문제

⛔ 문제

---

❓ 원인

---

❗ 해결

✅방법 1) sc.nextLine() 으로 개행문자 제거

🔍 기존의 코드를 메소드로 분리

✅ 따라서 일부 로직을 메소드로 분리

✔️ 코드가 구조적으로 더 깔끔해지며 유지보수가 용이
❌ 메소드 분리했음에도 오히려 코드가 더 복잡해 보이는 경우가 있음

💭 메소드 역할이 명확하지 않거나 메소드 이름이 직관적이지 않을 가능성

어려운점?

일정 업데이트 할때 업데이트 시점을 레포지토리에서 처리할 때 now()로 찍어서 업데이트하게 했는데.. 이렇게 해도 되는지? 이것도 비즈니스 로직이니까 서비스 레이어에서 값을 미리 넘겨주어야하는지 아니면 나중에 JPA를 쓰게 된다면 @LastModifiedDate < 같은 어노테이션으로 처리하는 게 좋은지

참고

https://browndwarf.tistory.com/48