파이썬 API, 이렇게 빨라도 돼? FastAPI, 초고속 웹 서버의 비밀을 파헤치다 (비개발자 탐구생활)

안녕하세요, 코딩은 못 하지만 IT가 너무 궁금한 비개발자 루카(Luka)입니다. 최근 개발자들 사이에서 "파이썬으로 API를 만드는데 엄청 빠르다더라", "심지어 Go나 Node.js에 비벼볼 만하다더라" 하는 이야기가 들리더군요. 제 귀에 들어온 이름은 바로 'FastAPI'였습니다. 파이썬이 느리다는 편견을 깨버린다는 이 프레임워크가 도대체 뭔지, 왜 이렇게 빠른지 너무 궁금해서 직접 파봤습니다! 제가 개발자는 아니지만, 비개발자의 시선으로 샅샅이 파헤쳐 본 FastAPI 탐구기를 시작합니다.

thumbnail

🤯 FastAPI, 그게 뭔데? (비개발자 눈높이 설명)

일단 FastAPI가 뭔지부터 알아야겠죠? 제가 알아본 바로는 FastAPI는 파이썬으로 웹 API를 만들 때 사용하는 일종의 '뼈대' 혹은 '프레임워크'입니다. 우리가 웹사이트를 만들 때 디자인 툴이나 템플릿을 쓰는 것처럼, 개발자들이 API를 효율적으로 만들 수 있도록 도와주는 도구라고 생각하시면 편합니다.

그런데 얘가 왜 이렇게 유명하고 특별할까요? 가장 큰 특징은 이름 그대로 '초고속'이라는 점입니다. 파이썬은 쉽고 강력하지만, 속도 면에서는 C++이나 Java, Go 같은 언어에 비해 다소 느리다는 인식이 있었습니다. 하지만 FastAPI는 이 단점을 상당 부분 극복해서, 특정 상황에서는 정말 놀라운 성능을 보여준다고 해요.

제가 찾아보니 FastAPI는 'Starlette'이라는 가벼운 웹 프레임워크를 기반으로 하고, 'Pydantic'이라는 데이터 유효성 검사 라이브러리를 사용해서 빠르고 안정적인 API 개발을 가능하게 합니다. 마치 고성능 스포츠카 엔진(Starlette)에 안전하고 정확한 내비게이션 시스템(Pydantic)을 달아준 격이랄까요?

🚀 지옥에서 온 속도! FastAPI가 미친 듯이 빠른 이유 (feat. 구체적인 수치)

자, 그럼 이제 본론입니다. FastAPI가 왜 이렇게 빠르다는 건가요? 제가 이 부분에서 가장 궁금했는데요, 몇 가지 핵심적인 이유가 있더군요.

1. 비동기 처리 (Async/Await) 지원: 멀티태스킹의 달인!

가장 중요한 이유는 바로 비동기(Asynchronous) 처리를 지원한다는 점입니다. 이게 뭔지 저 같은 비개발자는 좀 어려웠는데요, 간단히 말하면 동시에 여러 작업을 처리할 수 있다는 겁니다.

예를 들어, 식당에서 손님 A가 주문을 하고 요리가 나올 때까지 기다리는 동안, 손님 B가 주문하러 오면 그 주문을 받아야겠죠? 기존 파이썬 웹 프레임워크(Flask, Django의 일반적인 방식)는 손님 A의 요리가 다 나올 때까지 손님 B의 주문을 받지 못하고 기다리는 방식(동기 방식)과 비슷했습니다. 반면 FastAPI는 손님 A의 요리가 만들어지는 동안, 손님 B의 주문도 받고, 손님 C의 테이블도 치우고 하는 식으로 여러 일을 동시에 처리할 수 있는 겁니다.

제가 본 벤치마크 자료에 따르면, TechEmpower 웹 프레임워크 벤치마크에서 FastAPI는 Go나 Node.js 기반의 프레임워크와 어깨를 나란히 할 정도로 높은 성능을 보여주고 있습니다. 특히 수천 건의 동시 요청(concurrent requests)이 들어올 때, Flask나 Django 같은 전통적인 파이썬 프레임워크에 비해 3배에서 5배 이상 빠른 처리 속도를 보이는 경우가 많다고 합니다. 특정 JSON 응답 테스트에서는 Flask가 초당 약 1,500개의 요청을 처리할 때, FastAPI는 초당 8,000개 이상의 요청을 처리하는 결과도 봤습니다. 정말 압도적이죠?

2. ASGI 표준 채택: 신세대 웹 서버 인터페이스

FastAPI는 ASGI(Asynchronous Server Gateway Interface)라는 새로운 표준을 따릅니다. 기존 파이썬 웹 프레임워크들이 주로 사용하던 WSGI(Web Server Gateway Interface)는 동기 방식이었기 때문에 위에서 설명한 비동기 처리가 어려웠습니다. 하지만 ASGI는 태생부터 비동기 처리를 염두에 두고 설계되었고, 웹소켓(WebSocket) 같은 양방향 통신도 지원합니다.

이게 무슨 말이냐면, 웹 API 서버가 클라이언트 요청을 받을 때, ASGI를 통해 마치 새로운 고속도로를 쓰는 것처럼 더 빠르고 효율적으로 데이터를 주고받을 수 있다는 겁니다. 덕분에 FastAPI는 UVicorn이라는 ASGI 서버 위에서 동작하며, 이 UVicorn 자체가 매우 빠르고 효율적입니다.

3. Pydantic의 자동 데이터 유효성 검사 및 직렬화: 정확하고 빠른 데이터 처리

FastAPI가 빠른 또 다른 이유는 Pydantic 라이브러리를 영리하게 활용한다는 점입니다. API 서버는 클라이언트로부터 데이터를 받거나 클라이언트에게 데이터를 보내야 합니다. 이때 데이터의 형식이 맞는지, 빠진 정보는 없는지 일일이 확인하는 과정(유효성 검사)이 필요한데, Pydantic이 이 과정을 자동으로, 그리고 매우 효율적으로 처리해줍니다.

제가 찾아본 바로는 Pydantic은 파이썬의 타입 힌트(Type Hint) 기능을 활용해서 데이터를 정의하면, 들어오는 데이터가 그 정의에 맞는지 자동으로 검사하고, 잘못된 데이터는 오류 메시지를 발생시켜줍니다. 이 과정이 C 언어로 작성된 내부 로직을 통해 구현되어 있어서 매우 빠르다고 해요. 또한, 데이터를 JSON 형태로 변환하거나(직렬화), JSON을 파이썬 객체로 변환하는(역직렬화) 과정도 Pydantic이 담당해서 개발자가 따로 코드를 길게 작성할 필요 없이, 빠르고 오류 없이 처리됩니다. 이 덕분에 개발 시간도 줄어들고, 런타임 성능도 향상되는 일석이조의 효과를 얻습니다.

🛠️ 비개발자도 따라 할 수 있다? FastAPI 맛보기!

제가 직접 터미널에 이것저것 쳐보면서 FastAPI를 설치하고 실행해봤습니다. 놀랍게도 몇 줄 안 되는 코드로 정말 간단한 API 서버가 뚝딱 만들어지더라고요!

1단계: FastAPI와 UVicorn 설치하기

터미널을 열고 다음 명령어를 입력합니다. 저는 pip이라는 파이썬 패키지 관리자를 사용했습니다.

pip install fastapi uvicorn[standard]

uvicorn[standard]는 UVicorn 서버와 함께 필요한 추가 라이브러리(Gunicorn, websockets 등)를 한 번에 설치해줍니다. 이걸 치고 나니 촤라락 설치되는 모습이 꽤 멋있었습니다.

2단계: 간단한 API 서버 코드 작성하기

이제 main.py라는 파일을 만들고 아래 코드를 작성합니다.

from fastapi import FastAPI

# FastAPI 앱 객체를 생성합니다.
# 이게 우리 API 서버의 '뼈대'가 됩니다.
app = FastAPI()

# '/' 경로로 GET 요청이 오면 이 함수를 실행합니다.
# '비동기' 함수로 정의하는 것이 FastAPI의 핵심 중 하나입니다.
@app.get("/")
async def read_root():
    return {"message": "안녕하세요, 루카의 FastAPI 월드에 오신 것을 환영합니다!"}

# '/items/{item_id}' 경로로 GET 요청이 오면 이 함수를 실행합니다.
# {item_id} 부분은 변수로 받습니다.
@app.get("/items/{item_id}")
async def read_item(item_id: int, query_param: str = None):
    # Pydantic 덕분에 item_id가 자동으로 int 타입으로 검사됩니다.
    # query_param은 문자열이고, 값이 없으면 None이 됩니다.
    return {"item_id": item_id, "query_param": query_param, "message": f"아이템 {item_id}를 찾았습니다!"}

이 코드를 보면서 신기했던 건 item_id: int 같은 부분이었습니다. 개발자들은 이걸 '타입 힌트'라고 부르던데, 이 덕분에 FastAPI가 자동으로 item_id는 정수여야 한다고 알아채고 유효성 검사까지 해준다고 합니다. 비개발자 입장에서는 코드가 훨씬 깔끔하고, 나중에 API 설명서까지 자동으로 만들어준다니 정말 똑똑하네요!

3단계: API 서버 실행하기

이제 터미널에서 main.py 파일이 있는 경로로 이동한 다음, 다음 명령어를 입력합니다.

uvicorn main:app --reload

여기서 main:app은 main.py 파일 안에 있는 app 객체를 실행하라는 의미입니다. --reload 옵션은 코드를 수정할 때마다 서버를 자동으로 재시작해줘서 개발할 때 아주 편리하다고 합니다.

이 명령어를 치니 터미널에 "Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)" 같은 메시지가 뜨더라고요! 이제 웹 브라우저를 열고 http://127.0.0.1:8000으로 접속해보세요. 제가 작성한 "안녕하세요, 루카의 FastAPI 월드에 오신 것을 환영합니다!" 메시지가 JSON 형태로 뜰 겁니다.

그리고 http://127.0.0.1:8000/items/123?query_param=test_data 로 접속하면 { "item_id": 123, "query_param": "test_data", "message": "아이템 123를 찾았습니다!" } 라는 응답을 볼 수 있습니다. 정말 신기하지 않나요?

놀랍게도 FastAPI는 이 코드만으로도 API 문서를 자동으로 만들어줍니다. http://127.0.0.1:8000/docs 로 접속하면 멋진 대화형 API 문서(Swagger UI)가 뜨는 것을 확인할 수 있습니다. 직접 API를 테스트해볼 수도 있습니다!

🤔 비개발자가 헷갈리기 쉬운 부분 (루카의 솔직 고백)

제가 FastAPI를 파헤치면서 "이게 뭔 소리야?" 했던 부분을 몇 가지 꼽아봤습니다. 아마 저 같은 비개발자분들도 비슷하게 느끼실 거예요.

1. "ASGI? WSGI? 그게 밥인가요?"

헷갈리는 지점: 개발 글을 읽다 보면 ASGI, WSGI라는 용어가 자주 나옵니다. 이름만 봐서는 뭘 하는 건지 전혀 감이 안 오죠.
루카의 이해: 이건 파이썬 웹 서버와 애플리케이션이 서로 대화하는 '규칙' 혹은 '인터페이스'라고 생각하면 됩니다. 쉽게 말해, 구형 웹 서버가 쓰는 대화법이 WSGI라면, FastAPI 같은 신형 웹 서버가 쓰는 대화법은 ASGI입니다. ASGI가 더 새롭고 빠르며, 비동기 처리가 가능하도록 설계된 '모던한 대화법'이라고 이해하시면 됩니다. 저처럼 '아, 그냥 FastAPI는 더 신식 대화법을 쓰는구나' 정도로 생각하시면 마음이 편합니다.

2. `async def`와 `await` "이게 비동기 처리라고? 뭐가 다른 건데?"

헷갈리는 지점: 함수 앞에 async를 붙이고, 어떤 작업 앞에는 await를 붙이는 걸 보고 "그래서 뭘 기다린다는 거야?" 싶었습니다.
루카의 이해: 이건 정말 중요하고도 헷갈리는 부분입니다. async def는 "이 함수는 비동기로 실행될 수 있어요"라고 선언하는 겁니다. 그리고 함수 안에서 await는 "여기는 좀 시간이 걸리는 작업이니, 이 작업이 끝날 때까지 기다리지 말고 잠시 다른 일 하고 와도 돼"라고 시스템에 알려주는 역할입니다. 예를 들어, 데이터베이스에서 정보를 가져오는 데 0.1초가 걸린다면, 이 0.1초 동안 다른 요청을 처리하는 거죠. await가 없으면 그 0.1초 동안 아무것도 안 하고 기다리게 됩니다. 비개발자인 우리는 그냥 "더 효율적으로 여러 일을 처리하기 위한 마법의 단어"라고 생각하면 됩니다.

3. Pydantic으로 자동 문서화? "아니, 그냥 타입 힌트만 적었을 뿐인데?"

헷갈리는 지점: 코드에 item_id: int처럼 변수 옆에 타입을 지정한 것만으로 API 문서가 자동으로 만들어지고, 유효성 검사까지 된다는 게 믿기지 않았습니다.
루카의 이해: 이게 FastAPI의 가장 큰 장점 중 하나인데, 저도 처음엔 "엥? 이게 다야?" 싶었습니다. Pydantic이라는 똑똑한 라이브러리가 파이썬의 '타입 힌트'를 읽어서, 해당 데이터가 어떤 형태여야 하는지, 어떤 설명이 필요한지 다 파악하고 자동으로 문서와 유효성 검사 로직을 만들어주는 겁니다. 개발자는 최소한의 노력으로 최대의 효과를 얻는 거죠. 비개발자 입장에서는 "코딩을 적게 해도 똑똑하게 다 알아서 해주는 초능력" 정도로 이해했습니다. 덕분에 개발 생산성이 엄청나게 높아진다고 합니다.

📈 FastAPI vs. 전통적인 파이썬 웹 프레임워크 (비교표)

제가 알아본 바로 FastAPI가 기존 파이썬 프레임워크인 Flask나 Django와 어떻게 다른지 비개발자 시선에서 비교해보겠습니다. (주로 API 개발 관점)

특징/프레임워크	FastAPI	Flask	Django
목적	초고속 API 개발, 비동기 지원	가볍고 유연한 웹/API 개발	풀스택 웹 애플리케이션 (API+DB+템플릿 등)
속도/성능	매우 빠름 (ASGI, 비동기 덕분)	중간 (WSGI, 주로 동기)	중간 (WSGI, 주로 동기)
비동기 지원	기본 내장, 최적화	추가 라이브러리로 가능하나 제한적	추가 라이브러리로 가능하나 제한적
자동 문서화	기본 내장 (Swagger UI, ReDoc)	별도 라이브러리 필요	별도 라이브러리 필요
데이터 유효성	Pydantic으로 자동 검증/직렬화	개발자가 직접 구현하거나 라이브러리 추가	자체 ORM 및 Form 기능으로 구현
학습 곡선	파이썬 타입 힌트 이해 시 비교적 낮음	매우 낮음 (간단한 프로젝트에 적합)	높음 (방대한 기능과 규칙)
주요 사용처	고성능 백엔드 API, 마이크로서비스	소규모 API, 유틸리티, 간단한 웹앱	복잡한 웹사이트, 대규모 서비스
메모리 사용량	상대적으로 낮음 (공식 문서 기준, 작게는 1.2GB)	낮음	중간 ~ 높음

FastAPI의 메모리 사용량에 대한 구체적인 수치를 찾아보니, "비동기 서버와 함께 구동했을 때 약 1.2GB 내외"라는 자료를 발견했습니다. 물론 서비스의 복잡도에 따라 달라지겠지만, Flask나 Django에 비해서도 매우 효율적인 편이라고 합니다.

💡 루카의 결론: 비개발자가 본 FastAPI

솔직히 제가 직접 코딩해서 뭘 만들 수준은 아직 안 됩니다. 하지만 FastAPI를 파헤쳐보면서 느낀 건, 단순히 "빠르다"는 장점 외에도 정말 '개발자 친화적'이고 '생산성이 높다'는 거였습니다. 타입 힌트만 잘 써줘도 자동 문서화, 자동 유효성 검사까지 되니 개발자들이 작업 시간을 엄청나게 아낄 수 있겠더군요.

그리고 비동기 처리 덕분에 파이썬이 느리다는 인식을 깨고, Go나 Node.js 같은 다른 언어의 고성능 API와도 충분히 경쟁할 수 있다는 점이 가장 인상 깊었습니다. 앞으로 파이썬이 API 서버 개발 분야에서 더 큰 역할을 하게 될 것이라는 확신이 들었습니다.

저처럼 코딩을 잘 몰라도, 이 글을 통해 FastAPI가 왜 이렇게 핫한지 조금이나마 이해가 되셨으면 좋겠습니다. 기술은 정말 빠르게 발전하고 있고, 비개발자도 이런 변화를 알아가는 게 중요하다고 생각합니다. 언젠가는 저도 FastAPI로 간단한 API를 직접 만들어보는 날이 오기를 바라면서!

🔖 핵심 요약 (3줄)

FastAPI는 파이썬으로 초고속 웹 API 서버를 만들 수 있게 해주는 현대적인 프레임워크입니다.
비동기 처리(async/await), ASGI 표준, Pydantic을 활용하여 놀라운 속도와 개발 생산성을 자랑합니다.
자동 문서화 및 데이터 유효성 검사 기능 덕분에 개발자도, 서비스 사용자도 모두 편리합니다.

❓ 자주 묻는 질문 (FAQ)

Q1: FastAPI는 왜 이렇게 빠른가요? A1: FastAPI는 ASGI(비동기 웹 표준)를 사용하고 async/await 문법으로 비동기 처리를 효율적으로 합니다. 또한, C 언어 기반의 Pydantic 라이브러리로 빠른 데이터 유효성 검사와 직렬화를 수행하여 매우 빠른 속도를 낼 수 있습니다.

Q2: FastAPI를 사용하면 어떤 장점이 있나요? A2: 가장 큰 장점은 압도적인 API 처리 속도입니다. 더불어, 파이썬 타입 힌트를 활용한 자동 문서화(Swagger UI, ReDoc), 자동 데이터 유효성 검사, 간결한 코드 작성으로 개발 생산성이 크게 향상됩니다.

Q3: FastAPI는 어떤 프로젝트에 가장 적합한가요? A3: 고성능이 요구되는 백엔드 API 서버, 마이크로서비스, 실시간 데이터 처리, 웹소켓 통신이 필요한 애플리케이션 등에 특히 적합합니다. 파이썬의 쉬움과 속도라는 두 마리 토끼를 잡고 싶은 프로젝트에 강력하게 추천됩니다.

여러분도 저처럼 비개발자지만, 호기심만 있다면 이 정도의 IT 지식은 충분히 이해하고 알아갈 수 있습니다! 다음에도 궁금한 IT 기술을 들고 다시 찾아오겠습니다!