get_todos_handler 부분 쿼리 매개변수 인식 오류

from fastapi import FastAPI

app = FastAPI()


@app.get('/')
def heath_check_handler():
    return {'ping': 'pong'}


todo_data = {
    1 : {
        'id' : 1,
        'contents' : '실전! FastAPI 섹션 0 수강',
        'is_done' : True,
    },
    2: {
        'id': 2,
        'contents': '실전! FastAPI 섹션 1 수강',
        'is_done': False,
    },
    3: {
        'id': 3,
        'contents': '실전! FastAPI 섹션 2 수강',
        'is_done': False,
    },
}
# 내림차순(큰값 -> 작은값)
@app.get("/todos")
def get_todos_handler(order: str | None = None):
    ret = list(todo_data.values())
    if order and order == 'DESC':
        return ret[::-1]
    return ret

위와 같이 강사님 코드 그대로 실행하고, 패키지 버전도 FastAPI==0.97.0인데, 쿼리 매개변수가 인식이 안되는데, 무슨 문제일까요?

안녕하세요, 인프런 AI 인턴입니다.

문승주님께서 제공해주신 코드와 설명을 바탕으로, get_todos_handler에서 쿼리 매개변수가 인식이 안된다고 하신 문제를 해결해보겠습니다. 해당 문제는 몇 가지 이유로 발생할 수 있으며, 아래의 해결 방법을 시도해 보시기 바랍니다.

UVicorn 사용: FastAPI 앱을 실행할 때 uvicorn을 이용하여 --reload 옵션으로 실행하고 계신가요? 콘솔에서 uvicorn main:app --reload로 실행하여 변경 사항이 자동으로 반영되도록 해주세요.
인코딩 문제: URL에서 매개변수가 제대로 인코딩되어 있는지 확인해 보세요. 예를 들어, http://localhost:8000/todos?order=DESC와 같은 쿼리가 붙어있는지 확인해보세요.
FastAPI 버전 문제: FastAPI 버전을 최신 상태로 유지하고 있는지 확인해 주세요. 경우에 따라 라이브러리와의 호환성 문제일 수 있습니다.
매개변수 명확성: FastAPI에서 타입 힌팅은 매우 중요합니다. order: str | None = None가 올바르지만 Optional[str]와 같은 다른 표현방식을 사용해 볼 수 있습니다. 예를 들어:

   from typing import Optional
   
   @app.get("/todos")
   def get_todos_handler(order: Optional[str] = None):
       ...

이와 유사한 문제에 대한 참고 자료를 제공 드립니다:

DI 주입
- 이 게시물에서는 FastAPI의 종속성 주입 문제를 해결합니다.

위의 해결 방법을 시도해 보신 후에도 문제가 지속된다면, 보다 구체적인 오류 메시지나 서버 로그를 공유해 주시면 추가적인 도움을 드리겠습니다.

저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다.
현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏 추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.

인프런 커뮤니티 질문&답변