把博客升级到 Django 4.2 LTS:一次低风险、却有意外收获的升级
最近把站点从 Django 4.0 升级到了 4.2 LTS。原本以为这是一次“改两行依赖、重建镜像”的平淡操作,结果过程里有两个意外发现,值得记一笔——尤其是那个一直潜伏、从未被触发过的兼容性雷。
为什么要升
Django 4.0 早已结束生命周期(EOL),不再有安全补丁。而 4.2 是目前的 LTS 版本,能持续获得安全更新。另外,我后面想给后台管理界面换个更好看的皮(比如 django-unfold),它要求 Django ≥ 4.2,所以这次升级也是给下一步铺路。
升级前:先问“能不能升”
改动之前,先把项目实际代码和依赖扫了一遍,而不是凭感觉。
结论很乐观:
- 跨度小、无破坏性模型变更:4.0 → 4.2 同属 LTS 线,SQLite 库结构不变。数据库
db.sqlite3和静态目录static都是 bind mount 到宿主的,重建镜像不会动数据。 - 代码侧干净:全项目扫描,没有使用 4.1/4.2 已移除的 API(
ugettext、timezone.utc、force_text、django.conf.urls.url()等),gettext_lazy用法正常。 - 自定义后台模板安全:后台的
base_site.html只是{% extends "admin/base.html" %}加标准 block 覆盖,4.0→4.2 后台 block 没变,不会断。 - Python 不用动:镜像基础是
python:3.10-slim,Django 4.2 支持 3.8–3.12,完全覆盖。
动手:改两行依赖
requirements.txt 里只动一处:
Django==4.0 → Django==4.2.*
这里有个关于评论库的小插曲。本站已经自建了评论 app(sitecomments),没有把 django_comments 当 app 安装。但 sitecomments 仍会把 django-contrib-comments 当作底层库 import(抽象模型、表单、信号等),所以 requirements.txt 里那行不能删。
意外一:评论库其实不用升
一开始我打算把 django-contrib-comments 也升到 ≥2.3.0(据说 2.2.0 只支持到 4.1)。结果构建镜像时直接报错:
ERROR: Could not find a version that satisfies the requirement
django-contrib-comments<2.5.0,>=2.3.0
(from versions: 1.5, 1.5.1, ..., 2.2.0)
当前 pip 源最高只同步到 2.2.0,拉不到更高版本。
这反而让我做了一次实测:保留 2.2.0,直接用 Django 4.2 构建,再验证评论功能。结果:
manage.py check:System check identified no issues (0 silenced) —— 这意味着 Django 加载了所有 app(含自建的sitecomments),零错误、零弃用告警;- 评论钩子
get_model()、CommentForm、评论区渲染全部正常; migrate无新迁移。
也就是说,django-contrib-comments 2.2.0 作为底层库在 Django 4.2 下完全兼容,确实不需要升级。这也再次印证了“已经自建评论 app、只拿它当库用”的判断——它不参与数据表迁移,纯 import 使用,对版本不敏感。
意外二:七牛存储里藏着一个真雷
评论库虚惊一场,七牛存储却是个实打实的问题。
在验证 default_storage 能否正常加载时,直接炸了:
File ".../qiniustorage/backends.py", line 21
from django.utils.encoding import force_text, force_bytes, filepath_to_uri
ImportError: cannot import name 'force_text' from 'django.utils.encoding'
问题出在 django-qiniu-storage 2.3.1:它还在用 force_text,而 force_text 早在 Django 4.0 就已经移除了。
更微妙的是:这个错误在 4.0 时代也存在,只是本站上传走的是前端直传七牛,从不实例化 QiniuMediaStorage 这个类,所以一直没被触发——它是个潜伏的隐患,这次升级只是让它“浮出水面”。pip 源里也没有修复了这个问题的更新版本,只能自己 patch。
做法是在 Dockerfile.web 里固化一行修复,确保每次重建镜像都带上:
RUN sed -i 's/force_text/force_str/g' /usr/local/lib/python3.10/site-packages/qiniustorage/backends.py
force_str 在 Django 4.2 中可用,替换后 default_storage 顺利加载为 QiniuMediaStorage。
验证清单
升级完成后逐项核对,全部通过:
- Django 运行版本:4.2.30(LTS 最新补丁版)
manage.py check:no issues (0 silenced)- 七牛存储:
default_storage=QiniuMediaStorage,加载成功 - 线上冒烟:首页 / 文章详情 / 后台登录均返回 200
- 评论区渲染正常(数据库 60 条评论可读)
migrate:No migrations to apply
回滚与安全
升级前先做了一次数据库热备(backup-20261028-2226)。万一需要回退,只需还原 requirements.txt 与 Dockerfile.web 两处改动,重建并重启 web 容器即可回到 4.0,数据无损。
小结
这次升级最大的收获,不是“升到了 4.2”本身,而是顺手清掉了一个一直没暴露的七牛存储兼容性雷。如果不是这次升级逼着验证 default_storage,它还会继续潜伏,等到哪天真走 Django 侧上传时再炸。
下一步,就可以放心地去折腾后台美化了——毕竟已经站在 4.2 这个能跑现代后台主题的地基上。
Last Modified·2026年10月28日 22:44
您尚未登录,请先登录才能评论。