예외를 어디서 HTTP 응답으로 바꾸는가?

컨트롤러 경계의 전역 예외 처리기에서 바꾼다. 도메인 예외를 안정된 오류 코드와 HTTP 상태로 매핑하고 예상 밖 예외는 500으로 감춘다.

예상 가능한 실패는 의미가 드러나는 예외로 표현한다. 저장소 예외나 구현 메시지를 그대로 노출하면 API가 내부 기술에 묶인다.

처리기는 구체적인 예외부터 매핑한다. 필터에서 발생한 예외는 컨트롤러 처리기에 도달하지 않으므로 별도 경계가 필요하다.

로그는 한 경계에서 한 번 남긴다. 응답에는 추적 ID와 안정된 코드를 싣고 스택 트레이스와 민감한 메시지는 숨긴다.