fastapi

서론FastAPI 개발할 때 로컬에서 서버를 실행하려고 하면, 의외로 자주 만나는 에러들이 있다. 특히 uvicorn main:app --reload 같은 기본 커맨드로 실행할 때 생각보다 많은 시행착오를 겪게 된다.처음에는"엥? 왜 안켜지지?""아까 켜졌는데 왜 안돼?""어디가 문제야?"이런 당황스러운 순간이 온다.오늘은 내가 직접 FastAPI 개발하면서 겪었던, FastAPI(Uvicorn) 서버 실행 시 가장 자주 만나는 에러와 해결 방법을 정리해보려고 한다.본론[Errno 48] Address already in use에러 상황ERROR: [Errno 48] Address already in use이미 8000번 포트를 누가 쓰고 있다.uvicorn 기본 포트가 8000인데, 아까 띄워놓은 서버..

서론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..

서론FastAPI와 SQLAlchemy를 사용한 백엔드 개발을 하다 보면, 가장 기본적인 데이터 저장 흐름으로 db.add() → db.commit()을 익히게 됩니다. 하지만 어느 순간, db.flush()라는 생소한 메서드를 만나게 되는 경우가 있죠.이 함수는 왜 필요한 걸까요? 그냥 commit()만 하면 되는 거 아닌가요?이번 포스팅에서는 flush()와 commit()의 차이, flush()가 어떤 상황에서 필요한지, 그리고 실제 예제 코드에서는 어떻게 사용하는지를 초보자도 이해할 수 있게 정리해보겠습니다.본론flush()란 무엇인가요?db.flush()이 코드는 SQLAlchemy에서 세션에 등록된 작업들을 실제 DB에 반영하지만, 트랜잭션은 종료하지 않고 그대로 유지하는 역할을 합니다.좀 더..

서론FastAPI와 SQLAlchemy를 함께 사용할 때, 코드를 다음처럼 계층 분리하는 경우가 많습니다.router: 요청/응답 처리service: 비즈니스 로직 처리crud: DB 직접 접근이 구조는 유지보수성과 테스트 편의성을 높여주지만, 실제 DB와의 상호작용이 나뉘어 있기 때문에 데이터 저장 흐름을 정확히 이해하는 것이 중요합니다.그 중 하나가 바로 db.flush()입니다.db.flush()는 데이터를 실제 DB에 저장하되 트랜잭션은 유지하는 명령어입니다.db.commit()과는 달리, 다른 연산(예: insert → select)을 하기 위한 "중간 저장" 용도로 사용됩니다.본론상황예를 들어 브랜드를 생성하고, 생성된 브랜드의 ID로 브랜드-카테고리 연관 데이터를 추가하고 싶다고 해보죠.1...

서론UUID는 전 세계 어디서든 고유한 값을 만들기 위한 식별자다.FastAPI나 Django 같은 백엔드 프레임워크에서도 자주 사용된다.본문UUID란?UUID (Universally Unique Identifier)중복되지 않는 ID 값을 만들기 위한 표준 규격문자열처럼 생겼지만 실제로는 고정된 128비트 값 예시:e9db2b88-d246-4db5-a74c-d1cfc9f2d6beUUID 버전별 차이버전 이름생성방식특징uuid1()시간 기반현재 시간 + MAC 주소순서 보장, 시간 노출 가능성uuid3()이름 기반 (MD5)고정된 이름 + 네임스페이스 → 해시같은 입력 → 같은 UUIDuuid4()무작위 기반랜덤 값가장 많이 사용됨uuid5()이름 기반 (SHA-1)uuid3과 동일, 해시 알고리즘만 다..

💡 FastAPI에서 PostgreSQL까지 흐름 이해하기FastAPI로 백엔드 API를 만들다 보면 다음과 같은 단어들을 자주 마주하게 됩니다.각자 따로 설명을 찾아보면 이해가 가면서도 개발하다보면 이게 뭐엿지 하게되는 상황이 꼭 있기 마련이다!!그래서 공부한김에 이해하기쉽게 정리해서 포스팅해봤다.처음엔 각각이 따로 노는 것처럼 보이지만, 알고 보면 이들은 하나의 흐름으로 연결됩니다.PydanticSQLAlchemypsycopg2PostgreSQL스키마(schema)🧭 전체 흐름 요약FastAPI (Pydantic 스키마) ↓SQLAlchemy (ORM) ↓psycopg2 (드라이버) ↓PostgreSQL (데이터베이스)🧱 각 구성요소 역할구성요소 설명FastAPI요청/응답 처리,..

🧩 배경FastAPI에서 API 요청 값을 처리할 때 dict로 받을지, Pydantic 스키마로 받을지 고민한 적이 있다. 특히 부분 업데이트 (PATCH) 혹은 선택적 필드 처리가 필요한 상황에서 어떤 방식을 써야 할지 명확히 구분해두면 좋다.🧪 예제예를 들어, 아래와 같은 ProductUpdate 스키마가 있다고 가정하자:class ProductUpdate(BaseModel): name: Optional[str] = None price: Optional[int] = None url: Optional[str] = None category_id: Optional[int] = None1. Pydantic 방식으로 처리하는 예시def update_product_service(db:..

📌 문제 상황FastAPI에서 카테고리를 다음과 같은 구조로 저장한다고 가정하자.main_category: 대분류 (필수)sub_category: 중분류 (선택)sub_sub_category: 소분류 (선택)DB 설계 시 sub_category, sub_sub_category는 nullable=True 로 되어 있고,입력값이 없으면 None 혹은 ""(빈 문자열)로 들어올 수 있다.하지만!중복 체크를 할 때 "None"과 ""를 구분하지 않으면실제로는 같은 카테고리인데 중복으로 인식되지 않는 문제가 발생할 수 있다.⚠️ 실제 발생 가능한 예시POST /categories{ "main_category": "생활/건강", "sub_category": "생활용품", "sub_sub_category": ..

1. 개요Python 프로젝트를 규모 있게 운영하거나 협업하게 되면, 가장 먼저 맞춰야 할 게 코드 스타일과 품질 기준이다.Next.js나 TypeScript처럼 빌드 시 오류를 잡아주는 구조가 아니라, Python은 인터프리터 기반이라 실행 전 오류를 못 잡을 수 있다.그래서 코드 품질 유지와 오류 예방을 위해, 아래 도구들을 도입하게 된다:flake8: 문법 오류, 스타일 경고 감지black: 코드 자동 정렬isort: import 정렬mypy: 타입 검사pre-commit: 커밋 전에 위 도구들을 자동 실행1.1 관련 용어용어 의미 지금 상황과의 관련성Linting (린팅)문법 오류, 스타일 오류 탐지✅ flake8, isortFormatting (포맷팅)코드 자동 정렬✅ blackStatic An..