跳到正文
每周二、五更新 · 排障记录与可运行代码邮件订阅:hi@xiaoming1.cn
编程心得标志,字母 A 与代码尖括号组合编程心得Awesome Dev

Django 5.1 的 LoginRequiredMiddleware:少写 27 个装饰器

开放式办公室里多人坐在电脑前工作
开放式办公室里多人坐在电脑前工作。配图为免费图库实拍,与本文主题对应。

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 行的校验函数,只允许站内相对路径。

文中提到的命令与数据来自公开版本说明和本站测试机。换环境后数值会变,先在小规模数据上复跑一遍,再动生产。

相关

读完可以接着看

两件与本文问题域直接相关的产品。

把下一次故障写成可复用的记录

每周二、五发一封邮件,只放当周的排障笔记、命令清单和一处容易踩错的细节。不发广告,随时可退。

hi@xiaoming1.cn

也可以直接打电话:0668-339 7712,工作日 09:30 至 18:00。