[TIL] 🛠️일정관리 프로젝트(Develop) 트러블슈팅

🛠️ 트러블 슈팅

📌 JPA Auditing 동작 오류

⛔ 문제

• 타임스탬프를 출력하기 위해, @Builder를 적용한 엔티티에서 @EntityListeners(AuditingEntityListener.class) 적용 후 @CreatedDate로 생성일을 자동 입력하려 했으나 값이 정상적으로 저장되지 않음.

@Getter
@Builder
@JsonInclude(JsonInclude.Include.NON_NULL)
@EntityListeners(AuditingEntityListener.class)
public class ErrorResponse {
  @CreatedDate
  private final LocalDateTime timestamp;
  private final int status;
  ...


  public static ErrorResponse of(ErrorCode errorCode) {
    return ErrorResponse.builder()
        .status(errorCode.getStatus())
        ...
        .build();
  }
  
  ...
  
}

---

❓ 원인

• JPA Auditing은 JPA 라이프사이클 이벤트를 기반으로 함.
• persist, merge, remove 등의 작업에 의해 이벤트 트리거가 됨.
• 위의 예시 코드의 ErrorResponse는 엔티티가 아니므로(@Entity 어노테이션❌) JPA 라이프라이클에 따른 이벤트 트리거가 발생하지 않는다.
• 따라서 AuditingEntityListener.class 이 동작하지 않았음.

---

❗ 해결

• JPA 엔티티가 아니므로 인스턴스에 디폴트 값을 설정하는 것으로 해결.

• 예시 코드에서는 @Builer 패턴을 사용하고 있으므로, @Builder.Default를 사용하여 @Builer 로 생성 시에 디폴트 값으로 현재 시간을 저장하도록 변경하였다.

@Builder.Default
 private final LocalDateTime timestamp = LocalDateTime.now();

그 결과 타임 스탬프가 정상적으로 기록되는 것을 확인할 수 있다.

{
    "timestamp": "2025-04-04T02:35:55.5728417",
    "status": 400,
    "error": "Bad Request",
    "code": "U003",
    "message": "Email is Duplicated"
}

📌 @Valid 오류 메세지 출력

⛔ 문제

• Validation에서 message 파라미터로 설정한 오류 메세지가 제대로 출력되지 않음

ErrorResponse errorResponse = ErrorResponse.of(ErrorCode.INVALID_INPUT_VALUE, e.getMessage());

{
    "status": 400,
    "error": "Bad Request",
    "code": "C001",
    "message": "Validation failed for argument [0] in public java.lang.String org.example.scheduleprojectv2.controller.UserController.login(org.example.scheduleprojectv2.dto.LoginRequestDTO,jakarta.servlet.http.HttpServletRequest): [Field error in object 'loginRequestDTO' on field 'email': rejected value [yejin1234]; codes [Email.loginRequestDTO.email,Email.email,Email.java.lang.String,Email]; arguments [org.springframework.context.support.DefaultMessageSourceResolvable: codes [loginRequestDTO.email,email]; arguments []; default message [email],[Ljakarta.validation.constraints.Pattern$Flag;@3da63570,.*]; default message [올바른 형식의 이메일 주소여야 합니다]] "
}

---

❓ 원인

• 에러 메세지 파라미터 값을 제대로 꺼내오지 않음.

---

❗ 해결

• 필드 에러를 정확히 지정하여 defaultMessage를 가지고오게 함.

ErrorResponse errorResponse = ErrorResponse.of(ErrorCode.INVALID_INPUT_VALUE, bindingResult.getFieldErrors().get(0).getDefaultMessage());

{
    "status": 400,
    "error": "Bad Request",
    "code": "C001",
    "message": "올바른 형식의 이메일 주소여야 합니다"
}

🕵️‍♀️ 고민한 부분/어려웠던 부분

DTO ↔️ Entity 변환

방법1️⃣ 엔티티에 메소드 구현

• DTO 삭제나 변경 시 엔티티에서 직접 삭제 필요

방법2️⃣ 서비스 레이어에 구현

• 해당 엔티티의 서비스 레이어 외에서도 변환 메소드를 사용할 수 있음
• 서비스 레이어이의 책임을 벗어남

방법3️⃣ DTO에 메소드 구현

• 데이터 전송 이상의 책임을 가지게 되는걸까?
• 혹은 중복 코드 문제
• 이 방식대로 하려고 했으나 DTO에 값 변경으로 인한 보안 문제로 @Setter를 사용하지 않아 원하는 대로 생성이 안됨.
  ➡️ 1번 방식으로 사용
  
  
  

세션 저장 정보

• 로그인 세션 저장 시, 어떤 값들을 저장하면 좋을지?
  • 현재는 이메일, 이름 정도만 저장하도록 하였음.
• 매번 요청 때마다 DB에 접근하여 이름 같은 정보를 불러오는 것이 불편한데, 세션 정보에 저장된 값을 컨트롤러에서 알아서 불러오도록 할 수는 없을까?
  • 추가 조사 필요
    
    
    

Postman 테스팅 자동화

• 댓글 CRUD 테스트 시, 회원가입-로그인-일정 생성의 과정을 매번 반복해야 했음.
• 이러한 반복적인 필수 과정을 하나로 묶어 자동 실행할 수 있는 방법이 있을까?
  • Postman 기능 추가 조사 필요
    
    
    

영속성 전이(Cascade)

• 일정-사용자 N:1 연관 관계에서, 사용자가 삭제되면(회원 탈퇴) 해당 사용자와 연관된 일정도 함께 삭제될 필요가 있음.

• JPA CASCADE를 사용하기 위해선 @OneToMany로 양방향 설정을 해주어야 함.

  • 양방향 설정 시 N+1 문제, 순환 참조, NullPointer 참조 등과 같은 문제가 발생할 가능성이 있음.
  • 따라서 양방향 설정은 되도록 피하고 싶음.

• 조사해보니 @OnDelete(action= OnDeleteAction.CASCADE)를 사용하여 사용자가 삭제될 때 관련된 일정도 같이 삭제되도록 설정할 수 있음.

• 이 동작은 JPA가 아닌 DB 측에서 이루어지는 작업이므로 하나의 쿼리로 처리가 가능함.

• 현재 프로젝트에서는 @OnDelete 어노테이션으로 처리하였으나, 둘 중 어느 방식이 더 적절할지는 추가 조사 필요.

참고

• JPA Auditing
  https://stackoverflow.com/questions/56823730/spring-data-jpa-auditing-not-working-for-the-jparepository-update-method-with-m
  https://dev-allday.tistory.com/78
  https://velog.io/@hsbang_thom/Lombok-Builder.Default
  https://0soo.tistory.com/133