把鉴权从四十个路由里搬进依赖注入:一次真实的后端重构
【摘要】 记录日语学习系统后端从每个路由开头手写鉴权,收敛到 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)