Dev/Python

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

서론Prolog파이썬 프로젝트를 하다 보면 setup.py와 requirements.txt 이 두 가지 파일을 자주 만나게 됩니다:이 둘은 **모두 "패키지 설치와 관련 있는 파일"**이지만,역할은 완전히 다릅니다.requirements 만 알고 있다가 setup 검색해보다 헷갈려서 포스팅글로 정리해봤다.헷갈릴 수 있지만, 용도와 목적을 알면 어느 상황에 어떤 걸 써야 하는지 금방 이해할 수 있다.본론requirements.txt는 무엇인가요?requirements.txt는 이 프로젝트를 실행하려면 어떤 외부 라이브러리가 필요한지를 정리한 파일입니다.requests==2.31.0beautifulsoup4>=4.12.0selenium보통 pip install -r requirements.txt 명령어로 설..

부제 : “점점 코드가 커질수록 정리된 로그가 필요하더라고요” 서론Prolog파이썬을 처음 배우기 시작하면 대부분 책이나 강의에서 가장 먼저 알려주는 건 print() 문이다.프로그램이 잘 돌아가는지 확인할 때마다 "여기까지 왔나?" 하고 print("ok")를 찍어보게 된다.근데 나처럼 실무 프로젝트를 하다 보면 문득 이런 생각이 든다.“프린트가 너무 많다…”“에러 메시지 안 보인다…”“이거 운영 환경에서도 프린트 찍히는 거 맞아?”그러면서 슬슬 궁금해진다.“개발자들이 말하는 로깅은 뭐지?”본문로깅(logging)이란?logging은 파이썬 표준 라이브러리로, print() 대신 메시지를 더 체계적으로 기록할 수 있게 해주는 도구다.일반적으로는 아래와 같은 용도로 사용된다.디버깅을 위한 로그 출력코드 ..

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

1. 튜플이란?튜플(Tuple)은 여러 개의 값을 묶어서 하나의 객체로 처리할 수 있는 데이터 구조입니다. 리스트와 비슷하지만, 중요한 차이점은 **수정이 불가능(immutable)**하다는 점입니다. 리스트는 요소를 추가하거나 삭제할 수 있지만, 튜플은 한번 생성되면 값을 변경할 수 없습니다.2. 튜플의 특징불변성 (immutable): 튜플은 생성된 후 값을 변경할 수 없어요.순서가 있음: 리스트처럼 인덱스를 사용하여 튜플의 각 요소에 접근할 수 있어요.여러 데이터 타입을 묶을 수 있음: 튜플은 정수, 문자열, 불리언 등 다양한 타입의 값을 하나로 묶을 수 있어요.3. 튜플의 사용법튜플 생성# 튜플 생성my_tuple = (1, 2, 3, "apple", True)print(my_tuple)튜플에서 ..

💡 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:..