FastAPI中Depends返回数据类出现类型提示错误，如何解决？

你遇到的Pylance类型提示错误，大概率是以下几个原因导致的，对应解决方法如下：

1. 依赖函数未明确标注返回类型 #

如果require_auth函数没有标注返回类型为DecodedUser，Pylance无法正确推断它返回的是类实例，会误判为类本身（type[DecodedUser]）。

正确写法：

def require_auth(token: str = Depends(oauth2_scheme)) -> DecodedUser:
    # 这里写Token验证、解析逻辑
    # 最终返回DecodedUser实例
    return DecodedUser(id=123, username="demo_user")

2. Annotated导入错误 #

Python版本不同，Annotated的导入路径有区别：

• Python 3.9及以上：从标准库typing导入

  from typing import Annotated
  

• Python 3.8及以下：从typing_extensions导入

  from typing_extensions import Annotated
  

导入错误会直接导致类型提示逻辑失效。

3. 错误标注返回类型为type[DecodedUser] #

如果你的依赖函数返回类型写的是type[DecodedUser]，这表示返回的是类本身而非实例，Pylance会认为user参数是类类型，自然无法访问实例属性id。

需修正的错误示例：

# 错误写法，不要这样定义返回类型
def require_auth() -> type[DecodedUser]:
    return DecodedUser

4. FastAPI版本过低 #

旧版本FastAPI对Annotated+Depends的类型支持存在缺陷，建议升级到最新稳定版：

pip install --upgrade fastapi uvicorn

完整正确代码示例 #

from fastapi import FastAPI, Depends, HTTPException
from fastapi.security import OAuth2PasswordBearer
from pydantic import BaseModel
from typing import Annotated

# 定义用户数据类
class DecodedUser(BaseModel):
    id: int
    username: str

oauth2_scheme = OAuth2PasswordBearer(tokenUrl="token")

# 依赖函数，明确标注返回类型为DecodedUser实例
def require_auth(token: str = Depends(oauth2_scheme)) -> DecodedUser:
    if not token:
        raise HTTPException(status_code=401, detail="Token缺失")
    # 模拟Token解析逻辑
    return DecodedUser(id=1, username="test_user")

app = FastAPI()

@app.get("/user/info")
def get_user_info(user: Annotated[DecodedUser, Depends(require_auth)]):
    # 此时Pylance会正确识别user为DecodedUser实例，可正常访问id属性
    return {"user_id": user.id, "username": user.username}

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