normalized error
Nest 예외 응답 계약
도메인 오류, 인증 오류, 시스템 오류가 제각각 응답하면 프론트엔드는 매번 다른 분기를 가져야 한다. 예외 응답 계약은 이 차이를 하나의 틀로 맞춘다.
한 줄 요약: 오류 종류는 달라도 응답 모양은 같다예측 가능한 API가 유지보수성을 만든다.
오류 분류와 응답 전략
01도메인 오류
중복, 재고 부족, 상태 전이 실패는 409 또는 400 계열로 명확히 표현한다.
02인증 오류
토큰 없음과 만료를 구분해 로그인 이동 또는 갱신을 선택하게 한다.
03권한 오류
인증은 됐지만 접근할 수 없는 상황은 403으로 분리한다.
04시스템 오류
DB 장애와 외부 API 실패는 내부 상세를 숨기고 추적 키를 남긴다.
필터가 보장할 공통 응답
| 필드 | 예시 | 이유 |
|---|---|---|
| code | ORDER_STOCK_EMPTY | 화면 분기 기준 |
| message | 재고가 부족합니다. | 사용자 안내 |
| recover | 수량 조정 또는 장바구니 이동 | 다음 행동 제시 |