FastAPI中出现AttributeError: 'Depends' object has no attribute 'query'错误求助

你遇到的'Depends' object has no attribute 'query'错误，核心原因是代码中的db变量没有被正确注入实际的数据库会话实例，反而保留了Depends对象本身。最常见的触发场景是Session类型注解的导入错误，以下是具体解决步骤：

1. 修正Session的导入路径 #

确保你导入的是SQLAlchemy的Session，而非FastAPI的Session：

# 正确导入
from sqlalchemy.orm import Session

# 错误导入（会导致依赖注入失效）
# from fastapi import Session

2. 给数据库会话生成器添加类型注解 #

明确get_db_session的返回类型，帮助FastAPI正确识别需要注入的对象：

from sqlalchemy.orm import Session
from typing import Generator

def get_db_session() -> Generator[Session, None, None]:
    db = SessionLocal()
    try:
        yield db
    finally:
        db.close()

3. 验证SessionLocal的定义正确性 #

确保你正确初始化了SQLAlchemy的会话工厂：

from sqlalchemy import create_engine
from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy.orm import sessionmaker

# 替换成你的数据库URL
SQLALCHEMY_DATABASE_URL = "sqlite:///./test.db"

engine = create_engine(
    SQLALCHEMY_DATABASE_URL,
    # SQLite专属参数，其他数据库可移除
    connect_args={"check_same_thread": False}
)
SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)

Base = declarative_base()

4. 优化代码（可选） #

既然get_user_from_db已经通过依赖注入获取会话，调用时无需手动传参，让FastAPI自动处理：

@app.post("/initialize_user")
def initialize_user(
    email: str,
    existing_user: User | None = Depends(get_user_from_db),
    db: Session = Depends(get_db_session)
):
    if existing_user:
        return {
            "email": existing_user.email,
            "credit_balance": existing_user.credit_balance,
            "subscription_type": existing_user.subscription_type
        }
    else:
        new_user = User(email=email, credit_balance=20, subscription_type="trial")
        db.add(new_user)
        db.commit()
        db.refresh(new_user)
        return {
            "email": new_user.email,
            "credit_balance": new_user.credit_balance,
            "subscription_type": new_user.subscription_type
        }

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