API에 Bean Validation 적용 질문

학습하는 분들께 도움이 되고, 더 좋은 답변을 드릴 수 있도록 질문전에 다음을 꼭 확인해주세요.

1. 강의 내용과 관련된 질문을 남겨주세요.
2. 인프런의 질문 게시판과 자주 하는 질문(링크)을 먼저 확인해주세요.
(자주 하는 질문 링크: https://bit.ly/3fX6ygx)
3. 질문 잘하기 메뉴얼(링크)을 먼저 읽어주세요.
(질문 잘하기 메뉴얼 링크: https://bit.ly/2UfeqCG)

질문 시에는 위 내용은 삭제하고 다음 내용을 남겨주세요.
=========================================
[질문 템플릿]
1. 강의 내용과 관련된 질문인가요? (예/아니오) 예
2. 인프런의 질문 게시판과 자주 하는 질문에 없는 내용인가요? (예/아니오) 예
3. 질문 잘하기 메뉴얼을 읽어보셨나요? (예/아니오) 예

[질문 내용]
안녕하세요. API에 Bean Validation을 적용하는 단계에서 질문이 있습니다.

검증 오류 요청 단계에서 오류가 발생한 경우 json이 정상적인 DTO를 json으로 만드는 것이 아닌 bindingResult에서 데이터를 꺼내 새로운 error라는 객체에 담아 json으로 보내는 형식으로 로직을 만들었습니다.

이때 클라이언트측에서는 정상적인 상황에서는 item이라는 정상 객체가 json으로 반환되고 오류상황에는 error라고 하는 객체가 json으로 반환이 되게 되는데 두 경우 모두 response.status는 200으로 나오더라구요. 클라이언트 쪽에서 이 두 케이스를 분류하여 로직을 처리해야하는데 어떻게 구분하도록 해야하는지 모르겠어서 질문드립니다.

오류 검증에서 오류가 나타났을때 서버에서 status를 400으로 보내도록 만들면 될까요?

안녕하세요, 인프런 AI 인턴입니다.

오스즈님, API에서 Bean Validation 적용과 관련하여 클라이언트 측에서 정상 응답과 에러 응답을 구분하는 방법에 대한 질문이신 것 같습니다. 오류가 발생했을 때 서버에서 상태 코드를 400(Bad Request)으로 보내는 것은 클라이언트 측에서 응답을 구분하도록 하는 효과적인 방법 중 하나입니다. 이러한 접근 방식은 API 설계의 일반적인 규칙을 따르며, 클라이언트는 하나의 상태 코드만 확인함으로써 응답의 성공 여부를 쉽게 판단할 수 있습니다.

정상적인 상황에서는 HTTP 상태 코드 200(OK)과 함께 기대하는 데이터를 응답하고, 검증 오류와 같은 에러 상황에서는 HTTP 상태 코드 400과 함께 오류 내용을 담은 json 객체를 반환하는 것이 좋습니다. 이렇게 하면 클라이언트 측에서 HTTP 상태 코드만 보고도 응답을 쉽게 구분할 수 있으며, 필요한 경우 오류 메시지를 사용자에게 보여주거나 로깅할 수 있습니다.

또한, Spring에서는 @ExceptionHandler 및 @ControllerAdvice를 사용하여 예외 처리를 쉽게 관리할 수 있습니다. 이를 통해 어플리케이션 전역에서 발생할 수 있는 예외를 잡아 처리하고, 적절한 HTTP 상태 코드와 메시지를 클라이언트에게 반환할 수 있습니다.

아래 문서는 API에서 예외 상황을 처리하는 방법에 대한 구체적인 예시와 방법론을 제공하고 있기 때문에 오스즈님께 도움이 될 수 있습니다:

Bean Validation - HTTP 메시지 컨버터 강의 관련 질문입니다. 이 예제에서는 Bean Validation 관련 예외 처리를 어떻게 하는지에 대한 교육자의 답변이 있습니다. 여기서는 HTTP 응답 상태 코드를 조작하여 오류 응답을 클라이언트에 보내는 방법에 대한 설명이 포함되어 있습니다.

저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다.
현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏
추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.

인프런 커뮤니티 질문&답변