Django 工程
Django 6.1 生产升级清单:从 5.2 LTS 出发
Django 6.1.1 已在 2026 年 9 月发布,5.2 仍是 LTS。升级前把迁移、依赖、设置与回滚四件事理顺。
Django 的版本节奏很稳定:每年多个特性版本,其中每隔一个版本提供长期支持。截至目前,5.2 是 LTS,6.1.1 是较新的稳定版本。生产项目可以选择留在 LTS,也可以评估升级到 6.1,但不要在没有测试覆盖的情况下跨两个大版本。
第一步:先看发行说明里的 Backwards incompatible
升级文档里真正要读的不是新功能,而是「不兼容变更」与「弃用时间线」。把这两节打印出来逐条对照自己的代码:设置项改名、ORM 默认行为变化、模板标签调整,通常都在这里。
迁移要能安全回滚
# 升级前:确认迁移状态干净
python manage.py showmigrations
python manage.py makemigrations --check --dry-run
# 部署时:先迁移,再切流量
python manage.py migrate --plan
python manage.py migrate
给大表的字段添加操作准备两步策略:先加可空字段、回填数据,再加约束。一次性 ALTER TABLE 在大表上可能锁很久,而锁表时间就是故障时间。
依赖与设置一起更新
- DRF、django-filter、django-cors-headers 等扩展要确认支持目标版本。
- 用
python manage.py check --deploy扫一遍生产设置,它会指出缺少的安全项。 MIDDLEWARE顺序变化要谨慎,认证与会话相关中间件的位置会影响请求链路。- 自定义用户模型不要动,升级过程中任何用户表结构的变动都代价高昂。
验证顺序
- 本地全量测试通过。
- 预发布环境用生产数据脱敏副本跑一遍迁移与冒烟。
- 灰度一台应用服务器,观察错误率与慢查询。
- 确认回滚脚本可用,再全量发布。
升级不是一次提交,而是一段可以回滚的过程。
