FastAPI获取全部用户接口在Swagger返回null排查求助

云上老周

2026-6-15

问题原因及解决方案

核心问题：路由匹配顺序冲突

你遇到的问题是路由匹配优先级导致的：FastAPI会按照路由定义的先后顺序进行匹配，@router.get("/{username}")是动态路径参数路由，会优先匹配/all这个请求路径——它会把all当作username参数传入get_user接口，而数据库里没有username为all的用户，所以返回null，你的get_users接口实际上根本没被执行到。

而咖啡店的接口/coffee-shops/all没有这个问题，是因为它的路径前缀/coffee-shops和其他路由没有重叠，不会被动态参数路由误匹配。

解决方案

方案1：调整路由定义顺序

把固定路径的/all路由放在动态参数路由前面，让FastAPI优先匹配固定路径：

@router.get("/all")
def get_users(db: db_dependency):
    users = db.query(Users).all()
    return users

@router.get("/{username}")
def get_user(db: db_dependency, username: str):
    user = db.query(Users).filter(Users.username == username).first()
    return user

方案2：给动态路由添加路径前缀

修改动态参数路由的路径，避免和固定路径冲突，比如给用户详情接口加/user前缀：

@router.get("/user/{username}")
def get_user(db: db_dependency, username: str):
    user = db.query(Users).filter(Users.username == username).first()
    return user

@router.get("/all")
def get_users(db: db_dependency):
    users = db.query(Users).all()
    return users