예전 판은 FastAPI 0.136·Django 5.2·Flask 3.1을 «최신»으로 적었지만, 지금은 FastAPI 0.162.0·Django 6.1·Flask 3.1.3이다. 출처를 확인할 수 없는 벤치마크 환경(특정 클라우드 인스턴스)과 순위, 다른 회사 운영 사례, «현장에서 자주 보인다» 같은 문장은 뺐다. 실행 예시에서 버전 표기가 낡은 Docker Compose 설정과 외부 속도 제한 라이브러리 예제도 걷어 냈다.
핵심 차이 — 두 축으로 나누기
세 프레임워크의 차이는 두 축에서 대부분 설명된다. 첫째는 요청을 어떤 방식으로 받느냐(동기 WSGI인가, 비동기 ASGI인가), 둘째는 무엇을 기본으로 주느냐(ORM·인증·관리자까지 다 주는가, 라우팅만 주고 나머지는 고르게 하는가)다.
- Django — ORM, 마이그레이션, 인증·권한, 관리자 화면, 폼, 세션, 템플릿을 한 묶음으로 주는 풀스택 프레임워크다. WSGI와 ASGI를 모두 지원하고, ASGI로 배포하면 요청 처리 전체가 비동기로 돈다.
- FastAPI — 처음부터 ASGI 위에 만든 API 전용 프레임워크다. 함수의 타입 힌트가 곧 요청 검증 규칙(Pydantic v2)이 되고, 그 규칙이 자동 OpenAPI 문서(
/docs)가 된다. 내부는 Starlette 위에 올라가 있다. - Flask — 라우팅과 요청·응답만 주는 작은 WSGI 프레임워크다. ORM은 SQLAlchemy, 검증은 Marshmallow나 Pydantic처럼 필요한 것을 직접 골라 붙인다.
API만, 타입 검증과 문서를 자동으로 → FastAPI / 관리자·인증·DB까지 한 번에 → Django / 작은 서비스를 필요한 부품만으로 → Flask.
2026년 10월 기준 판과 지원 기간
프레임워크를 고를 때 판 번호보다 중요한 것은 지원 기간과 Python 요건이다. 아래 표는 2026년 10월 29일 PyPI와 각 공식 페이지에서 확인한 값이다.
| 항목 | FastAPI | Django | Flask |
|---|---|---|---|
| 최신 판 | 0.162.0(2026-10-23) | 6.1.2(6.1 출시 2026-08-05) | 3.1.3(2026-02-19) |
| Python 요건 | 3.10 이상 | 6.0·6.1 = 3.12 이상(5.2까지 3.10·3.11 지원) | 3.9 이상 |
| 지원 기간 | 판 번호 0.x, 별도 LTS 없음 | 6.1 확장 지원 2027-12 · 5.2 LTS 2028-04 | 별도 LTS 표 없음 |
| 주요 의존 | Starlette 0.46 이상, Pydantic 2.9 이상 | asgiref(비동기 연결) | Werkzeug 3.1 이상, Jinja 3.1.2 이상 |
Python 쪽도 함께 봐야 한다. python.org 기준 3.15가 2026-10-09에 나왔고, 3.10은 2026-10-01로 지원이 끝났다. FastAPI와 Flask는 아직 3.10 이하도 설치를 허용하지만, 지원이 끝난 Python 위에서 새 서비스를 시작할 이유는 없다. Django 6.x를 쓰려면 처음부터 3.12 이상을 깔아야 한다.
Django 6.1 릴리스 노트는 달력식 판 번호로 옮긴다고 적는다. 원래 7.0·7.1로 예정됐던 판은 Django 2028·2029가 된다. 업그레이드 계획을 세울 때 «7.0을 기다린다» 같은 메모는 고쳐 두는 편이 좋다.
같은 기능을 세 가지로
«/hello에 이름을 받아 인사를 돌려준다»는 같은 기능을 세 프레임워크로 써 보면 결이 바로 보인다.
# Flask 3.1 — 최소 구성, 동기
from flask import Flask, request, jsonify
app = Flask(__name__)
@app.get("/hello")
def hello():
name = request.args.get("name", "world")
return jsonify(message=f"Hello, {name}")
# 실행: flask --app app run
# ---------------------------------------------------------
# FastAPI 0.162 — 타입 힌트가 곧 검증, 문서는 /docs 에 자동
from fastapi import FastAPI
app = FastAPI()
@app.get("/hello")
async def hello(name: str = "world"):
return {"message": f"Hello, {name}"}
# 개발 실행: fastapi dev app.py (pip install "fastapi[standard]")
# ---------------------------------------------------------
# Django 6.1 — views.py 와 urls.py 를 나누는 관례
# views.py
from django.http import JsonResponse
def hello(request):
name = request.GET.get("name", "world")
return JsonResponse({"message": f"Hello, {name}"})
# urls.py
from django.urls import path
from . import views
urlpatterns = [path("hello", views.hello)]코드 길이만 보면 Flask와 FastAPI가 짧고 Django가 길다. 하지만 Django는 이 뒤에 붙는 인증, 관리자 화면, DB 스키마 변경(마이그레이션)을 프레임워크가 정한 방식으로 이어 준다. 기능이 쌓일수록 «직접 고르고 엮어야 하는 부품 수»가 Flask와 FastAPI 쪽에서 늘어난다는 점이 진짜 차이다.
비동기 처리 — 같은 async def, 다른 결과
세 프레임워크 모두 async def 뷰를 쓸 수 있다. 그래서 «셋 다 비동기 지원»이라고 묶기 쉽지만, 공식 문서를 읽어 보면 동작이 꽤 다르다.
| 상황 | FastAPI | Django | Flask |
|---|---|---|---|
| 기본 서버 방식 | ASGI | WSGI·ASGI 둘 다 | WSGI |
| async def 뷰 | 이벤트 루프에서 바로 실행 | ASGI면 비동기 스택 전체, WSGI면 요청마다 일회용 이벤트 루프 | 요청마다 스레드에서 이벤트 루프를 띄워 실행 (flask[async] 필요) |
| 일반 def 뷰 | 외부 스레드 풀에서 실행 | ASGI에서는 스레드로 넘겨 실행 | 워커가 그대로 처리 |
| 동시 처리량 | I/O 대기가 긴 요청이 많을 때 유리 | ASGI 배포에서 긴 연결(스트리밍·롱 폴링)에 유리 | 비동기 뷰여도 요청 하나 = 워커 하나 |
FastAPI 문서는 await를 지원하지 않는 라이브러리로 DB·외부 API를 부른다면 async def 대신 일반 def로 쓰라고 안내한다. 일반 def 함수는 외부 스레드 풀에서 돌기 때문에 서버를 막지 않는다. 반대로 async def 안에서 막히는 호출(동기 DB 드라이버, time.sleep)을 쓰면 이벤트 루프 전체가 멈춘다. FastAPI를 골랐다면 «비동기 드라이버를 쓰는가»부터 정해야 하는 이유다.
Django는 SQL을 실행하는 모든 QuerySet 메서드에 a가 붙은 비동기 짝(aget, acreate, afirst, asave 등)을 두고 async for도 받는다. 다만 문서는 트랜잭션이 아직 비동기 모드에서 동작하지 않는다고 적는다. 트랜잭션이 필요한 부분은 동기 함수로 묶어 sync_to_async()로 부르라고 권하고, 비동기 모드에서는 CONN_MAX_AGE 영구 연결 대신 DB 쪽 커넥션 풀을 쓰라고 안내한다.
# Django — 비동기 뷰 + 비동기 ORM, 트랜잭션은 동기 함수로
from asgiref.sync import sync_to_async
from django.db import transaction
from django.http import JsonResponse
from .models import Order, User
async def user_summary(request, user_id):
user = await User.objects.aget(id=user_id)
count = await Order.objects.filter(user=user).acount()
return JsonResponse({"name": user.name, "orders": count})
def _pay(order_id):
with transaction.atomic(): # 트랜잭션은 동기 쪽에서
order = Order.objects.select_for_update().get(id=order_id)
order.paid = True
order.save()
async def pay(request, order_id):
await sync_to_async(_pay)(order_id)
return JsonResponse({"ok": True})Flask 문서는 더 직설적이다. 비동기는 그 자체로 동기 코드보다 빠르지 않고, 비동기 뷰에서도 요청 하나가 워커 하나를 쓰므로 한 번에 처리할 수 있는 요청 수는 그대로라고 적는다. 한 요청 안에서 외부 API 여러 개를 동시에 부르는 데는 쓸모가 있다. 뷰 안에서 asyncio.create_task로 띄운 작업은 뷰가 끝나면 취소되므로, 뒤에서 돌릴 일은 작업 큐로 넘겨야 한다.
FastAPI — Pydantic v2 전용과 lifespan
FastAPI에서 예전 튜토리얼을 따라 할 때 가장 먼저 부딪히는 곳이 Pydantic 판이다. 공식 문서의 정리는 이렇다.
- 0.100.0 — Pydantic v1과 v2 중 설치된 쪽을 썼다.
- 0.119.0 — v2 안의
pydantic.v1모델을 옮겨 가는 동안 임시로 받았다. - 0.126.0 — Pydantic v1 지원을 뺐다.
- 0.128.0 —
pydantic.v1지원까지 뺐다. 지금 판에서 v1 모델을 쓰면 오류가 난다.
Pydantic 쪽도 Python 3.14부터는 v1을 지원하지 않는다. 그러니 class Config, @validator, .dict() 같은 v1 문법이 보이는 예제는 model_config, @field_validator, .model_dump()로 바꿔 읽어야 한다.
두 번째는 시작·종료 처리다. FastAPI 문서는 @app.on_event("startup") 절을 «deprecated»로 표시하고, FastAPI(lifespan=...)에 비동기 컨텍스트 매니저를 넘기는 방식을 권한다. 둘을 섞어 쓸 수는 없다. lifespan을 넘기면 startup·shutdown 처리기는 더 이상 불리지 않는다.
from contextlib import asynccontextmanager
from fastapi import Depends, FastAPI
from pydantic import BaseModel, Field
@asynccontextmanager
async def lifespan(app: FastAPI):
app.state.pool = await create_pool() # 시작: 커넥션 풀 만들기
yield
await app.state.pool.close() # 종료: 정리
app = FastAPI(lifespan=lifespan)
class ItemIn(BaseModel):
name: str = Field(min_length=1)
price: float = Field(gt=0)
async def get_conn():
async with app.state.pool.acquire() as conn:
yield conn
@app.post("/items")
async def create_item(item: ItemIn, conn=Depends(get_conn)):
row = await conn.fetchrow(
"INSERT INTO items(name, price) VALUES($1, $2) RETURNING id",
item.name, item.price,
)
return {"id": row["id"], **item.model_dump()}Depends로 받은 DB 연결·현재 사용자·설정은 테스트에서 app.dependency_overrides로 갈아 끼울 수 있다. FastAPI를 고르는 실질적인 이유는 속도보다 이 «타입 = 검증 = 문서 = 주입» 묶음에 있다. 관리자 화면·ORM·마이그레이션은 들어 있지 않으니 SQLAlchemy·Alembic 같은 부품을 따로 정해야 한다.
Django 6.0·6.1에서 바뀐 것
예전 판이 «Django 5.2가 표준»이라고 적은 뒤로 두 판이 더 나왔다. 2025-12-03에 나온 6.0과 2026-08-05에 나온 6.1이다. 선택에 영향을 주는 것만 골랐다.
| 판 | 바뀐 것 | 무엇이 달라지나 |
|---|---|---|
| 6.0 | 백그라운드 작업 프레임워크 django.tasks | @task로 정의하고 .enqueue()로 넣는다. 작업을 실제로 돌리는 워커는 Django가 주지 않으므로 별도 실행 환경이 필요하다. 내장 백엔드 둘은 주로 개발·시험용이다. |
| 6.0 | 템플릿 조각 {% partialdef %} | 한 템플릿 안에 이름 붙인 조각을 두고 템플릿#조각으로 따로 그릴 수 있다. 화면 일부만 바꾸는 요청에 쓰기 좋다. |
| 6.0 | CSP 내장 지원 | SECURE_CSP·SECURE_CSP_REPORT_ONLY 설정과 nonce로 콘텐츠 보안 정책 헤더를 만든다. |
| 6.1 | 필드 가져오기 방식 fetch_mode() | 지연 로딩 필드를 하나씩(FETCH_ONE), 같은 QuerySet 단위로 묶어서(FETCH_PEERS) 가져오거나, 아예 막아서(FETCH_RAISE) N+1을 개발 중에 잡을 수 있다. |
| 6.1 | DB 수준 삭제 옵션 | on_delete=DB_CASCADE 등은 SQL의 ON DELETE를 쓴다. 이때 pre_delete·post_delete 신호는 불리지 않는다. |
| 6.1 | MAILERS 설정 | 메일 백엔드 여럿을 이름으로 나눠 쓴다. 기존 EMAIL_* 설정은 지원 중단 예정으로 표시됐다. |
6.1은 PostgreSQL 14, MySQL 8.4 미만, MariaDB 10.11 미만 지원도 끝냈다. 오래된 DB 위에서 돌던 프로젝트라면 Django 판보다 DB 판을 먼저 올려야 할 수 있다. Django REST Framework로 API를 만드는 흐름은 Django REST API 개발 실무 가이드에 따로 정리해 두었다.
Flask — 작게 시작하고 필요한 만큼 붙이기
Flask의 강점은 지금도 «작다»는 것이다. 의존성은 Werkzeug, Jinja, Click, itsdangerous, Blinker 정도이고, 웹훅 수신기나 내부 도구, 화면 몇 장짜리 서비스는 파일 하나로 끝난다. DB, 폼 검증, 로그인은 확장으로 붙이므로 무엇을 넣을지 팀이 정해야 한다.
비동기가 필요해지면 선택지가 셋이다. 첫째, pip install "flask[async]"로 async def 뷰를 쓴다(한 요청 안의 동시 호출용). 둘째, Flask 문서가 소개하는 gevent로 돌린다. 셋째, 코드 대부분이 비동기라면 Flask 문서가 직접 권하는 Quart로 옮긴다. Quart는 Flask를 ASGI 위에 다시 구현한 것이라 많은 동시 요청, 긴 요청, 웹소켓을 워커 여러 개 없이 처리한다.
Flask 문서는 비동기 지원 이전에 만들어진 확장의 데코레이터가 async def 뷰에서는 동작하지 않을 수 있다고 경고한다. 쓰려는 확장의 변경 기록에서 비동기 지원 여부부터 확인하자.
Python free-threading은 어디까지 왔나
GIL 없이 도는 free-threaded 빌드는 PEP 779(최종 승인 2025-06-16)에 따라 Python 3.14에서 공식 지원이지만 선택 사항인 단계에 들어갔다. 기본 빌드가 된 것은 아니며, 기본으로 바꿀지는 다음 PEP에서 정한다.
PEP 779는 이 단계의 기준으로 단일 스레드 성능 저하 15% 이내, 메모리 증가 20% 이내를 잡았고, 작성 당시 측정값을 약 10%(macOS 약 3%)와 15~20%로 적었다. 백엔드 입장에서는 «CPU를 오래 쓰는 작업을 스레드로 진짜 병렬 처리할 길이 열렸다»는 뜻이지만, 쓰는 C 확장(DB 드라이버, 이미지 처리 등)이 free-threaded 빌드를 지원하는지 먼저 확인해야 한다. 지금 프레임워크를 고르는 기준까지 바꿀 정도는 아니다.
고르는 기준과 옮길 때
| 이런 프로젝트라면 | 먼저 볼 것 | 이유 |
|---|---|---|
| 관리자 화면, 로그인, 복잡한 DB 관계가 있는 웹 서비스 | Django | ORM·마이그레이션·인증·관리자가 한 묶음, LTS로 오래 운영 |
| 프런트·앱이 부르는 JSON API, 외부 호출이 많은 서비스 | FastAPI | ASGI, 타입 기반 검증, OpenAPI 문서 자동 |
| 웹훅 수신, 내부 도구, 작은 화면 몇 장 | Flask | 의존성이 적고 구조를 직접 정하기 쉬움 |
| 실시간 연결(웹소켓, 스트리밍)이 중심 | FastAPI 또는 ASGI로 배포한 Django | WSGI의 Flask는 긴 연결에 맞지 않음(필요하면 Quart) |
| 오래 손대지 않고 돌릴 사내 시스템 | Django 5.2 LTS | 확장 지원 2028년 4월까지 |
꼭 하나만 고를 필요도 없다. Django로 관리자·인증·DB를 맡기고, 외부 호출이 많은 일부 API만 FastAPI 서비스로 떼어 같은 DB나 메시지 큐를 보게 하는 구성도 흔한 선택지다. 이때 API 모양을 정하는 문제는 GraphQL vs REST API 선택 가이드를, 다른 언어로 API 서버를 비교해 보고 싶다면 Go REST API 서버 구축을 함께 보면 좋다. 여러 서비스를 한 번에 띄우는 방법은 Docker Compose 멀티 컨테이너 운영 가이드에 정리했다.
Python 판부터 맞춘다
3.10은 지원이 끝났다. Django 6.x를 쓸 계획이면 3.12 이상, 새로 시작하면 3.13이나 3.14 위에서 의존 라이브러리 설치를 먼저 확인한다.
예제 코드의 판을 확인한다
FastAPI 예제에 on_event나 Pydantic v1 문법이, Django 예제에 EMAIL_BACKEND만 쓰는 메일 설정이 보이면 지금 판 문서로 다시 확인한다.
성능은 자기 워크로드로 잰다
남이 잰 초당 요청 수보다 내 서비스의 DB·외부 API 호출 비율이 결과를 더 크게 바꾼다. 같은 엔드포인트를 두 방식으로 만들어 부하 도구로 비교한다.
자주 묻는 것
FastAPI가 Django나 Flask보다 항상 빠른가요?
항상 그렇지는 않습니다. FastAPI는 ASGI 위에서 도는 비동기 프레임워크라 외부 API·DB 응답을 기다리는 시간이 긴 요청을 많이 받을 때 유리합니다. 다만 FastAPI 문서도 await를 지원하지 않는 라이브러리를 쓰면 일반 def로 쓰라고 안내하고, Flask 문서는 비동기가 그 자체로 동기 코드보다 빠르지 않다고 적습니다. 숫자 비교는 자기 워크로드로 직접 재야 합니다.
옛 FastAPI 튜토리얼의 Pydantic v1 코드가 지금도 돌아가나요?
돌아가지 않습니다. FastAPI 공식 문서에 따르면 0.126.0에서 Pydantic v1 지원을, 0.128.0에서 pydantic.v1 지원까지 뺐고, 지금 판은 Pydantic v2만 받습니다. Pydantic v1은 Python 3.14 이상에서 지원되지 않으니 v2 문법(model_config, field_validator 등)으로 옮겨야 합니다.
Django를 지금 새로 시작하면 어느 판을 고르나요?
2026년 10월 기준 최신 판은 Django 6.1(2026-08-05 출시, 확장 지원 2027년 12월까지)이고, 장기 지원판은 5.2 LTS(확장 지원 2028년 4월까지)입니다. 새 기능이 필요하면 6.1, 업그레이드 주기를 길게 가져가야 하면 5.2 LTS가 맞습니다. Django 6.x는 Python 3.12 이상이 필요합니다.
Flask에서 async def를 쓰면 동시 처리량이 늘어나나요?
늘어나지 않습니다. Flask 문서는 WSGI 앱인 Flask가 비동기 뷰에서도 요청 하나에 워커 하나를 쓰고, 한 번에 처리할 수 있는 요청 수는 그대로라고 설명합니다. 한 요청 안에서 여러 외부 호출을 동시에 보내는 데는 쓸모가 있고, 코드 대부분이 비동기라면 ASGI 기반인 Quart를 고려하라고 권합니다.
정리
FastAPI vs Django vs Flask의 답은 «무엇이 가장 빠른가»가 아니라 «무엇을 만들고, 얼마나 오래 돌리나»에서 나온다. 타입 기반 검증과 자동 문서가 핵심인 API라면 FastAPI 0.162(Pydantic v2 전용), 관리자·인증·DB까지 한 번에 끝내야 하는 서비스라면 Django 6.1이나 5.2 LTS, 작고 가볍게 필요한 부품만 붙일 서비스라면 Flask 3.1이 맞다. 어느 쪽이든 예전 튜토리얼의 판을 먼저 확인하고, 성능은 자기 워크로드로 직접 재는 것이 가장 확실하다.
참고 자료
- PyPI. fastapi — 0.162.0, Python 3.10 이상, Starlette 0.46·Pydantic 2.9 이상(2026-10-29 확인). pypi.org
- PyPI. Flask — 3.1.3(2026-02-19), Python 3.9 이상, Werkzeug 3.1 이상(2026-10-29 확인). pypi.org
- Django. Download — 지원 판 표(5.2 LTS·6.0·6.1, 지원 종료 시점)(2026-10-29 확인). djangoproject.com
- Django 6.0 release notes — 2025-12-03, Python 3.12~3.14, Tasks·템플릿 조각·CSP(2026-10-29 확인). docs.djangoproject.com
- Django 6.1 release notes — 2026-08-05, fetch_mode·DB 수준 삭제·MAILERS·달력식 판 번호·DB 지원 종료(2026-10-29 확인). docs.djangoproject.com
- Django. Asynchronous support — ASGI·WSGI에서의 비동기 뷰, a 접두사 ORM 메서드, 비동기 모드 트랜잭션 제한, sync_to_async(2026-10-29 확인). docs.djangoproject.com
- FastAPI. Migrate from Pydantic v1 to Pydantic v2 — 0.126.0·0.128.0 지원 종료 일정(2026-10-29 확인). fastapi.tiangolo.com
- FastAPI. Lifespan Events — lifespan 권장, on_event 절 deprecated, 둘은 함께 쓰지 않음(2026-10-29 확인). fastapi.tiangolo.com
- FastAPI. Concurrency and async / await — 일반 def는 외부 스레드 풀에서 실행(2026-10-29 확인). fastapi.tiangolo.com
- Flask. Using async and await — flask[async], 요청 하나 = 워커 하나, 백그라운드 작업 주의, Quart 권장 조건(2026-10-29 확인). flask.palletsprojects.com
- python.org. Downloads — 활성 판 표(3.15 2026-10-09 출시, 3.10 2026-10-01 지원 종료)(2026-10-29 확인). python.org
- PEP 779 — Criteria for supported status for free-threaded Python(Final, 2025-06-16 승인)(2026-10-29 확인). peps.python.org