FastAPI中普通函数使用Depends注入数据库会话报错：AttributeError: 'Depends' object has no attribute 'query'

先直接说核心问题：你遇到的错误是因为FastAPI的依赖注入系统只在路由函数（被@app.get/@app.post等装饰器修饰的函数）和被Depends引用的依赖函数中自动解析Depends对象，普通函数直接调用时，Python会把Depends(...)当作默认值传给参数，而不是解析成实际的数据库会话，所以db变成了Depends实例，自然没有query方法。

另外你的代码里还有两个容易忽略的小bug，先一起修正：

• 查询语句错误：db.query(bd.User.username)只会查询username字段，返回的是元组而非User对象，后续访问user.password_hash会报错，应该改成db.query(bd.User)
• 过滤条件错误：filter(username == username)是恒成立的无效条件，应该改成filter(bd.User.username == username)，才能根据传入的用户名匹配数据库中的用户

下面给出两种可行的解决方案，以及对应的原理说明：

方案一：将认证函数转为依赖函数（推荐） #

把authenticate_user改成一个可被依赖注入的函数，这样FastAPI会自动解析它内部的依赖（包括数据库会话）：

from fastapi import Depends, HTTPException, status

# 修正后的认证函数
def authenticate_user(username: str, password: str, db: Session = Depends(get_db)):
    # 修正查询和过滤逻辑
    user = db.query(bd.User).filter(bd.User.username == username).first()
    if not user:
        return False
    if not verify_password(password, user.password_hash):
        return False
    return user

# 在路由中使用这个依赖
@app.post("/login")
def login(username: str, password: str, user = Depends(authenticate_user)):
    if not user:
        raise HTTPException(
            status_code=status.HTTP_401_UNAUTHORIZED,
            detail="Incorrect username or password",
        )
    # 后续可添加生成JWT Token等逻辑
    return {"message": "Login successful", "user": user.username}

当FastAPI处理/login请求时，会自动递归解析authenticate_user的所有依赖：先调用get_db获取数据库会话，再把会话传给authenticate_user的db参数，最后把认证结果传给路由函数的user参数。

方案二：手动传入数据库会话（适合直接调用认证函数的场景） #

如果你需要在普通函数中直接调用authenticate_user，可以去掉它参数里的Depends，改为在调用时手动传入已解析的数据库会话：

# 修改认证函数，移除Depends默认值
def authenticate_user(username: str, password: str, db: Session):
    user = db.query(bd.User).filter(bd.User.username == username).first()
    if not user:
        return False
    if not verify_password(password, user.password_hash):
        return False
    return user

# 在路由中先获取数据库会话，再调用认证函数
@app.post("/login")
def login(username: str, password: str, db: Session = Depends(get_db)):
    user = authenticate_user(username, password, db)
    if not user:
        raise HTTPException(
            status_code=status.HTTP_401_UNAUTHORIZED,
            detail="Incorrect username or password",
        )
    return {"message": "Login successful", "user": user.username}

这种方式下，authenticate_user就是一个普通的Python函数，完全依赖外部传入的数据库会话，不会触发FastAPI的依赖注入逻辑。

关于FastAPI依赖注入的核心原理 #

FastAPI的依赖注入是绑定到请求处理流程的：

1. 当你用@app.get/@app.post等装饰器标记函数时，FastAPI会把它注册为路由处理函数，并追踪所有带有Depends的参数。
2. 处理请求时，FastAPI会递归解析每个Depends：调用对应的依赖函数（比如get_db），获取其返回值（比如Session实例），再把值注入到目标参数中。
3. 只有路由函数和被Depends引用的函数，才会触发这个解析流程；普通函数直接调用时，Python只会使用参数的默认值（也就是Depends对象本身），不会触发依赖解析。

内容的提问来源于stack exchange，提问作者TobaSko