Django老项目升级到新版本

手上有个 Django 老项目,一直跑得好好的,好几年没动过了,维护费收得正爽,没想到客户来了个新的运营人员,丢了个改动需求过来。我一看也没啥大改,就答应了。大意了。

问题

刚开始改,我这种老鸟当然知道老项目万万不可升级依赖的版本。于是先爬上服务器,把服务器上用的 Python 版本和 Django 版本都先摸了一遍,记下了用的是 Python 3.4 和 Django 1.8,然后开始安装开发环境。

首先是我的 MacBook Pro 是 M2 CPU,而老的 Python 3.4 版本只支持 x86 架构。尝试指定 arch 也没有成功,只能接受命运安排,用 Python 3.11 建了一个 virtualenv 开始安装 Django 1.8。

安装的时候没有问题,把各个依赖项都装上了。用 python manager.py runserver 一跑测试,发现 Django 1.8 内部使用了很多 Python 3.11 已经弃用的特性。这没法改啊,只能硬着头皮用新版本了。然后去 Django 官网查,发现一直到 Django 4.1 才开始支持 Python 3.11。得,那就选择 4.x 最大的版本吧,直接升级到 Django 4.2.11。没敢升 5.0,怕变化太大,要改太多。

手动升级

继续用 python manager.py runserver 跑测试,一开始都是些 ImportError: cannot import name 'url' from 'django.conf.urls' 之类的小错误,直接复制到 Google 就能找到解决方法手动升级。

神器 django-upgrade

手动修复几次之后,终于来了一个让人头大的错误了。

复制代码
TypeError: ForeignKey.__init__() missing 1 required positional argument: 'on_delete'

一看出错位置,在一个生成的数据库迁移文件里:

复制代码
....../migrations/0001_initial.py", line 33, in Migration

秉持生成的代码不要手动去改的原则,另外也深知可能还有无数个类似的 ForeignKey 代码,不可能改得过来。

是时候去想想办法了。

然后搜索找到了神器 Django-upgrade。从文档里看出,它基于标准库中的 asttokenize 库处理代码,速极快,处理 15.3 万行的 Python 代码只需要 0.5 秒。

它可以通过分析代码,把所有不兼容的代码版本直接升级到指定的版本,比如把原来的代码升级到 4.1 版本,以下命令行就可以直接办到。

复制代码
django-upgrade --target-version 4.1 example/core/models.py example/settings.py

类似 ForeignKey 需要加 on_delete 参数之类的错误,完全不在话下。新版本的 django-upgrade 可以把 django 项目的代码升级到 1.7~5.0 版本,成功解决了我的问题。

意外收获 pyupgrade

pyupgrade 可以自代码的语法自动升级到新的版本。比如去除弃用的特性,去除 python2 与 python3 兼容时代留下的 six 相关代码等。

相关推荐
AI视觉网奇38 分钟前
音频获取长度
java·前端·python
zfoo-framework1 小时前
线上redis的使用
数据库·redis·缓存
寄思~1 小时前
学习笔记:封装和单继承
开发语言·笔记·python·学习
典孝赢麻崩乐急1 小时前
Redis学习-----Redis的基本数据类型
数据库·redis·学习
E_ICEBLUE1 小时前
Python 操作 Word 文档:主流库对比与选择指南
开发语言·经验分享·python·word·办公自动化
倔强青铜三1 小时前
苦练Python第38天:input() 高级处理,安全与异常管理
人工智能·python·面试
大模型真好玩1 小时前
深入浅出LangChain AI Agent智能体开发教程(六)—两行代码LangChain Agent API快速搭建智能体
人工智能·python·agent
止水编程 water_proof2 小时前
MySQL——事务详解
数据库·mysql
德育处主任Pro2 小时前
『React』 组件通信全攻略
python·opencv·matplotlib
爱喝水的鱼丶2 小时前
SAP-ABAP:SAP ABAP OpenSQL JOIN 操作权威指南高效关联多表数据
运维·开发语言·数据库·sap·abap