2026년 10월 17일 FastAPI 0.143.4가 공개됐습니다. 이번 마이너 수정만 보면 선택적 의존성에 httpx2를 추가한 변경이지만, 직전 이틀 동안 있었던 스트리밍 오류 수정과 함께 확인할 가치가 있습니다.
실제 운영에서는 ‘최신 버전이니까 무조건 안전하다’보다 현재 프로젝트가 SSE·JSONL 스트림을 내보내는지, 그리고 OpenTelemetry 자동 설정에 의존하는지부터 파악하는 것이 중요합니다. 버전별 변경은 반드시 구분해서 이해하세요.
2026년 10월 중순 FastAPI 변경 사항
공식 릴리스 노트 기준 0.143.2(10월 15일)는 프런트엔드 대체 파일 탐색 과정의 블로킹 문제를 수정했습니다. 0.143.3(10월 16일)는 JSONL과 SSE 스트림에서 유한하지 않은 실수값(non-finite float) 직렬화 문제를 수정했습니다. 0.143.4(10월 17일)는 선택적 의존성에 httpx2를 추가했습니다.
따라서 ‘0.143.4가 SSE 버그를 처음 수정했다’고 쓰면 부정확합니다. 배포 이력상 오류 수정은 0.143.3에 반영됐고 0.143.4를 설치하면 그 직전 패치도 포함되는 구조입니다.
SSE·JSONL 스트림에서 무엇을 확인할까
SSE(Server-Sent Events)는 서버에서 클라이언트로 이벤트를 지속적으로 전달할 때 사용하고, JSONL은 각 줄에 JSON 레코드 하나를 담는 표현 방식입니다. 응답에 일반 JSON으로 표현하기 어려운 NaN, Infinity 같은 값이 포함되면 직렬화 과정에서 예상치 못한 결과나 오류가 발생할 수 있습니다.
기존 코드를 변경하기 전에 데이터 발생 지점에서 유한하지 않은 실수값이 왜 만들어지는지 확인하세요. 예를 들어 측정 실패 결과를 NaN으로 그대로 보내는 대신 값을 누락하거나 명시적인 오류 상태를 전달하는 설계가 더 명확할 수 있습니다. 프레임워크 패치가 데이터의 의미까지 자동으로 해결하는 것은 아닙니다.
현재 버전 확인과 업데이트 절차
가상환경을 활성화한 다음 python -m pip show fastapi로 실제 설치된 버전을 확인할 수 있습니다. 사용하는 패키지 관리자가 uv라면 uv pip show fastapi 등 해당 환경에 맞는 명령을 사용하세요.
업데이트는 프로젝트의 의존성 파일과 잠금파일을 먼저 확인한 뒤 테스트 환경에서 수행합니다. pip 환경에서는 python -m pip install -U fastapi가 기본 예시지만, 운영 서비스는 특정 버전 범위를 고정했거나 다른 라이브러리와 호환성 문제가 있을 수 있으니 무조건 전체 의존성을 갱신하지 않는 편이 좋습니다.
업데이트 후에는 이벤트 스트림 구독, 연결 종료, 잘못된 데이터 입력, 예외 처리, JSON 응답 형식을 최소 한 번씩 재검증하세요. 버전 변경만으로 네트워크 프록시의 버퍼링 문제까지 해결되지는 않습니다.
OpenTelemetry 자동 설정은 0.143.0에서 변경
10월 8일 공개된 0.143.0에서 FastAPI는 OpenTelemetry exporter 자동 구성을 기본 활성화가 아니라 명시적 선택 방식으로 바꿨습니다. 과거에는 OTEL_* 환경변수만으로 관련 exporter 구성을 기대했다면 동작 차이가 생길 수 있습니다.
기존 방식이 필요하면 공식 문서대로 환경변수 FASTAPI_OTEL_AUTO_CONFIGURE=true를 설정하거나 애플리케이션 구성에 FastAPI(telemetry={"auto_configure": True})를 지정하는 방법을 검토합니다. 이미 자체 provider·exporter를 구성하는 애플리케이션은 별도 조치가 필요하지 않을 수 있습니다.
운영 서버 업그레이드 전에 실행할 회귀 테스트
첫 번째는 설치 버전과 Python 실행 경로가 일치하는지 확인하는 것입니다. 두 번째는 핵심 API의 정상·비정상 요청을 검사하는 것입니다. 세 번째는 장시간 스트리밍 연결과 클라이언트 재접속 동작을 보는 것입니다.
네 번째는 관측 도구에 trace가 정상 전송되는지 확인하는 것입니다. 다섯 번째는 문제가 생겼을 때 이전 잠금파일과 배포 버전으로 되돌릴 수 있도록 백업 및 롤백 지점을 남기는 것입니다. 특히 실시간 서비스라면 스테이징에서 작은 트래픽으로 먼저 검증하세요.
공식 변경 기록과 추가 학습 링크
상세한 버전별 변경 사항은 FastAPI 공식 Release Notes에서 확인할 수 있습니다. 0.143.4·0.143.3·0.143.2·0.143.0의 날짜와 변경 내용을 각각 조회하는 것이 가장 확실합니다.
Python 업그레이드가 필요한 프로젝트라면 사이트의 기존 Python 3.15 환경 업그레이드 글을 먼저 확인하고 개발환경을 맞추세요. 버전과 의존성 관리는 서비스마다 다르므로 테스트와 롤백 계획을 먼저 세우는 것이 안전합니다.