2024 年 8 月 7 日,Django Software Foundation 发布 5.1。LoginRequiredMiddleware 让整站默认要求登录,不必在每个视图上重复写 login_required 装饰器。
- 发布机构:Django Software Foundation,发布时间 2024 年 8 月 7 日
- 版本信息:Django 5.1,支持 Python 3.10 至 3.13
- 改造样本:一个后台站点 27 个视图,删掉 27 个装饰器
27 个装饰器的重复
后台站点有 27 个视图,其中 24 个需要登录,3 个是登录页、健康检查和回调。旧写法在每个函数上贴 @login_required,新增视图时经常忘,测试也没覆盖到,直到上线才被扫描出来。
5.1 的 LoginRequiredMiddleware 加进 MIDDLEWARE 后默认全部视图要求登录,用 @login_not_required 标记例外。27 个装饰器删到 3 个例外标记,代码少了 24 行,新增视图默认安全。
中间件的执行顺序
LoginRequiredMiddleware 要放在 SessionMiddleware 之后、CommonMiddleware 之前。放在最前面会因为读不到 request.user 而把所有请求重定向到登录页,包括静态文件和登录页本身。
它对 DRF 的 APIView 不生效,因为 DRF 有自己的认证流程。项目里同时有模板视图和 API 时,中间件只保护模板部分,API 仍然要单独配置权限类,别以为加了中间件就全站安全。
GeneratedField 的用法
5.1 新增 GeneratedField,可以把计算列交给数据库生成。我们把订单表的总价改成 generated_field,表达式是 quantity * unit_price,数据库在写入时自动算,应用层不再维护两个字段的一致性。
PostgreSQL 17 支持 STORED 生成列,MySQL 8.0 也支持。SQLite 的兼容性有限,测试库用 SQLite 时会出现迁移失败,CI 里最好换成 PostgreSQL,避免开发与生产行为不一致。
升级检查清单
先确认 Python 版本在 3.10 到 3.13 之间,Django 5.1 不支持 3.9。然后跑 python manage.py check --deploy,把 CSRF_TRUSTED_ORIGINS 和 SECURE_* 配置补齐,最后再改中间件。
登录跳转的 next 参数要验证白名单,避免开放重定向。中间件默认把原始路径塞进 next,攻击者可以构造外部地址,项目里要加一个 12 行的校验函数,只允许站内相对路径。



