본문 바로가기

웹개발

TIL | 오류 메시지에만 매몰되지 않기

문제 상황

인증·인가 기능을 구현하던 중 Postman으로 회원가입 요청을 보냈는데, 계속해서 이메일 중복 오류가 발생했다.

처음에는 이메일 중복 검증 로직이나 커스텀 예외 처리에 문제가 있다고 생각했다.

if (adminRepository.existsByEmail(request.getEmail())) {
    throw new DuplicateEmailException();
}

코드를 여러 번 확인했지만 특별한 문제를 발견하지 못했고, 원인을 찾기 위해 커스텀 예외 처리까지 제거하며 테스트했다. 그러나 같은 오류가 계속 발생했다.


원인

문제의 원인은 이메일 중복 로직이 아니라 Postman 요청 데이터의 password 필드 오타였다.

예를 들어 DTO에서는 다음 필드명을 사용하고 있었지만,

private String password;

Postman에서는 다른 이름으로 요청을 보내고 있었다.

{
  "email": "test@example.com",
  "passowrd": "password123!"
}

password가 아닌 passowrd로 작성되어 요청 값이 정상적으로 전달되지 않았다.


왜 이메일 중복 오류가 표시되었을까?

실제 원인과 반환된 오류 메시지가 달랐다는 점도 문제를 찾기 어렵게 만들었다.

이메일 중복 오류가 반복되자 자연스럽게 다음 부분만 집중해서 확인했다.

  • existsByEmail() 동작 여부
  • 데이터베이스에 동일한 이메일이 존재하는지
  • 커스텀 예외 클래스
  • GlobalExceptionHandler
  • 이메일 중복 검사 순서

하지만 요청 Body 전체와 DTO 필드가 정확히 일치하는지는 늦게 확인했다.

오류 메시지는 문제를 찾기 위한 중요한 단서지만, 항상 실제 원인을 정확히 가리킨다고 단정할 수는 없다.


해결 방법

Postman의 요청 Body를 DTO 필드명과 비교한 후 오타를 수정했다.

{
  "email": "test@example.com",
  "password": "password123!"
}

수정 후 회원가입 요청이 정상적으로 처리되는 것을 확인했다.


이번 문제를 통해 배운 점

이번에는 화면에 표시된 이메일 중복 오류에만 집중한 나머지, 요청 데이터 전체를 확인하지 못했다.

디버깅할 때는 특정 코드만 반복해서 보는 것보다 요청부터 응답까지 전체 흐름을 순서대로 확인해야 한다.

Postman 요청 데이터
        ↓
Controller와 DTO 바인딩
        ↓
Validation
        ↓
Service 비즈니스 로직
        ↓
Repository와 데이터베이스
        ↓
예외 처리와 응답

특히 API 요청 오류가 발생하면 다음 항목을 먼저 점검해야 한다.

  1. HTTP Method와 URL이 올바른가?
  2. Header와 Content-Type이 올바른가?
  3. Request Body의 필드명과 값이 정확한가?
  4. DTO의 필드명 및 타입과 요청 데이터가 일치하는가?
  5. Validation 오류가 발생하지 않았는가?
  6. 서비스 로직과 데이터베이스 상태가 정상인가?
  7. 예외 처리기가 실제 오류를 올바르게 반환하고 있는가?

개선할 점

다음부터는 오류 메시지만 따라가지 않고, 가장 바깥쪽인 요청 데이터부터 안쪽의 비즈니스 로직까지 순서대로 확인해야겠다.

또한 요청 필드가 누락되거나 오타가 발생했을 때 더 명확한 메시지를 받을 수 있도록 DTO에 Validation을 적용하는 것도 필요하다.

@NotBlank(message = "이메일은 필수 입력값입니다.")
@Email(message = "올바른 이메일 형식이 아닙니다.")
private String email;

@NotBlank(message = "비밀번호는 필수 입력값입니다.")
private String password;

이를 통해 비밀번호가 정상적으로 전달되지 않았을 때 이메일 중복 오류가 아니라 다음과 같이 실제 원인에 가까운 응답을 받을 수 있다.

{
  "code": "VALIDATION_FAILED",
  "message": "비밀번호는 필수 입력값입니다."
}

오늘의 회고

오류 메시지는 정답이 아니라 원인을 찾기 위한 단서이다.

이번 경험을 통해 코드에 문제가 있다고 단정하기 전에 Postman 요청값, DTO 바인딩, Validation, 비즈니스 로직을 넓은 시야로 점검해야 한다는 것을 배웠다.