오류 계약

예외 처리 응답 계약

HttpException, 커스텀 예외, 필터를 함께 사용해 상태 코드, 에러 본문, 로깅 위치를 일관되게 유지합니다.

발생 지점

의미 있는 예외

서비스와 컨트롤러는 실패 원인에 맞는 예외를 던져 호출자에게 의도를 전달합니다.

기본 응답

빌트인 예외

BadRequestException, NotFoundException처럼 HTTP 상태와 메시지가 정해진 클래스를 활용합니다.

공통 변환

ExceptionFilter

필터는 예외를 잡아 표준 에러 형식, 타임스탬프, 요청 경로를 채웁니다.

운영 기록

로깅과 노출 분리

내부 원인은 로그에 남기고 클라이언트에는 상태 코드와 복구에 필요한 메시지만 노출합니다.