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

: JQ SiteMap 제작 뒷이야기서론왜 만들게 되었을까?티스토리 블로그를 운영하면서 가장 불편했던 건,사이트맵(sitemap.xml)이 자동으로 제대로 생성되지 않는다는 점이었다.기본 제공되는 sitemap은 /category, /tag, /guestbook 등글과 무관한 링크까지 포함되어 있고, 정작 글 본문은 잘 노출되지 않기도 한다.“아예 내가 자동으로 sitemap을 생성해서 배포하면 안 될까?”본론주요 요건 및 이슈비개발자도 사용가능하도록 github ui 로만 설정해야 한다리스트를 어디서 긁어올 것인가스킨과 테마에 따라 링크 셀렉터가 다 다른데 어떻게 파싱 할 것인가최대한 단순하게 만들어서 자동 배포 되도록 해야 한다.크롤링 기반 자동 생성기로 전환하기처음에는 단순하게 생각했다.글 목록만 ..

서론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)튜플에서 ..

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