backend

서론FastAPI로 백엔드 API를 개발하다 보면 공통 응답 포맷을 설계하는 것이 중요해진다.예외 상황에서는 400, 404, 500 등 다양한 상태 코드와 함께 에러 응답을 반환하게 되는데 예외 상황에서도 성공 응답과 동일한 구조로 내려주면, 클라이언트 측에서도 구조적 파싱과 UX 대응이 쉬워진다.이 글에서는 FastAPI에서 CommonResponse를 기반으로 성공/실패/예외까지 하나의 응답 구조로 통일하는 방법을 소개한다. 실제 디렉터리 구조와 함께 샘플 코드도 포함되어 있다.본론디렉토리 구조 예시app/├── main.py # API 엔트리포인트 (라우터)└── core/ ├── response.py # 공통 응답 스키마 정의 └─..

서론FastAPI에서 예외 응답도 CommonResponse로 처리하는 이유API 개발을 하다 보면 "예외가 발생했을 때 어떤 형식으로 응답을 내려줘야 할까?" 하는 고민을 많이 하게 된다. FastAPI를 사용하면서 나는 CommonResponse라는 공통 응답 포맷을 도입했고, 처음에는 단순히 성공한 응답에만 적용했었다.그런데 문제는 예외가 발생했을 때였다. 예외도 결국 응답인데, 이걸 CommonResponse로 감싸야 하나? 그냥 HTTPException처럼 detail만 내려줘도 되는 거 아닌가? 처음엔 나도 헷갈렸다.본문😵‍💫 내가 겪은 혼란예외 처리 코드를 작성하다가 문득 이런 의문이 들었다."raise로 예외를 던졌는데, 이게 응답이 되면 성공인가 실패인가?"raise NotFoundE..