如何在FastAPI应用中验证Django哈希密码？遇UnknownHashError报错

数据老陈

2026-6-26

解决Django迁移FastAPI的密码验证UnknownHashError问题

问题根源

你的错误是因为Passlib无法识别Django生成的pbkdf2_sha256$260000$格式哈希串——Django的PBKDF2哈希有自己的特定结构（前缀+迭代次数+盐+哈希值），而你配置的通用pbkdf2_sha256 scheme不兼容该格式。同时代码中存在笔误，导致密码处理逻辑错误。

修复步骤

修正密码获取的笔误
代码里的password = pwd._context(form.get("password"))是错误写法：pwd._context是无效变量，且Passlib的verify方法需要接收明文密码，无需提前哈希。直接改为：
```
password = form.get("password")
```
修改CryptContext的Scheme配置
将通用的pbkdf2_sha256替换为Passlib专门适配Django的django_pbkdf2_sha256 scheme，这个scheme能正确解析Django生成的哈希格式：
```
pwd_context = CryptContext(schemes=["django_pbkdf2_sha256"], deprecated="auto")
```

完整修正后的代码

# Security config
security = HTTPBasic()
pwd_context = CryptContext(schemes=["django_pbkdf2_sha256"], deprecated="auto")


async def login(request: Request):
    form = await request.form()
    username = form.get("username")
    password = form.get("password")  # 修正笔误，直接取明文密码
    db = database.SessionLocal()
    user = db.query(models.User).filter(models.User.username == username).first()

    if not user or not pwd_context.verify(password, user.password):
        raise HTTPException(status_code=401, detail="Invalid username or password")
    token = create_jwt_token(user.id)
    response = RedirectResponse(url="/index", status_code=301)
    response.set_cookie(key="token", value=token)
    return response