Skip to content

文件:core/dependencies.py

负责关卡访问权限校验。

函数定义与行为

_extract_bearer_token(request: Request) -> str | None

Authorization: Bearer <token> 中提取 token,未命中返回 None

check_level_permission(required_level: int)

返回一个依赖函数 _checker,用于 FastAPI 依赖注入。

校验流程

  1. required_level == 0:直接放行,并设置 request.state.player
  2. 缺 token:401 Missing token
  3. token 解析失败:401 Invalid token
  4. 指纹不匹配:401 Fingerprint mismatch
  5. 关卡等级不足:403 Level locked
  6. 通过:将 payload 写入 request.state.player