把鉴权从四十个路由里搬进依赖注入:一次真实的后端重构

举报
yd_259563879 发表于 2026/11/16 10:46:17 2026/11/16
【摘要】 记录日语学习系统后端从每个路由开头手写鉴权,收敛到 FastAPI 依赖注入统一判权的完整过程,包含三个真实踩到的坑。

做日语学习系统后端时,最初每个路由函数开头都要写一遍取当前用户、再判断角色。等路由涨到四十多个,这种写法的代价就显出来了:漏写一处就是一个未授权入口,改一次规则要翻几十个文件。

问题不在重复,在契约

真正的问题不是重复代码,而是权限判定和业务逻辑挤在同一个函数体里,共用局部变量。读代码的人没法从函数签名看出这个接口允许谁访问——接口契约被藏进了实现细节。

收敛到依赖

FastAPI 的依赖注入很适合做这件事。把「当前用户」和「角色要求」拆成两层依赖,路由只声明自己要什么:

async def require_role(*roles: str):
    async def checker(user: User = Depends(current_user)) -> User:
        if roles and user.role not in roles:
            raise HTTPException(403, "forbidden")
        return user
    return checker

@router.get("/admin/stats")
async def stats(user: User = Depends(require_role("admin"))):
    ...

收益不在于少写几个 if,而在于函数签名本身成了权限声明。扫一眼路由表就知道哪些接口是管理员专属,评审时漏掉鉴权的概率明显下降。

三个坑

第一个是依赖顺序:把数据库会话依赖写在鉴权依赖之后,鉴权里拿不到 session。第二个是异常映射:业务层抛的领域异常必须在全局 handler 里转成统一响应体,否则鉴权失败返回 FastAPI 默认的 detail 结构,前端要写两套解析逻辑。

第三个最隐蔽:测试里用 dependency_overrides 替换鉴权时,如果替换的是内层 current_user 而不是外层 require_role 返回的 checker,角色判断仍然会真实执行,于是出现「测试全绿但线上 403」。

结果

重构后鉴权相关代码从散落在四十多个函数收敛到两个依赖定义,单个路由平均少六行。更重要的是加新接口时不需要「记得去加鉴权」——忘写依赖会立刻在签名上暴露出来。

这类重构没有新技术,价值全在让错误写不出来。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。