Django 2.2 升级至 4.2 需显式设置 DEFAULT_AUTO_FIELD（如 'django.db.models.BigAutoField'），否则触发 models.W042 警告；同时须用 django-upgrade 工具修复模型语法、改用 STORAGES 替代旧文件存储配置，并将数据库引擎改为 'django.db.backends.postgresql' 以适配 psycopg3。
DEFAULT_AUTO_FIELD 必须显式设置，否则迁移会报 models.W042 警告
Django 2.2 升级到 4.2 是跨两个大版本（2.x → 3.x → 4.x）的 LTS 到 LTS 迁移，不兼容改动集中在 ORM、配置、中间件和第三方依赖适配上。最直接、几乎必现的问题就是主键字段默认行为变更：
- Django 2.2 默认用
AutoField生成隐式主键，而 4.2 要求你明确指定类型 - 不设置
DEFAULT_AUTO_FIELD会导致每次运行python manage.py makemigrations都触发models.W042警告，且未来版本可能直接报错
解决方法很简单，在 settings.py 顶部或靠前位置加一行：
DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'推荐用
BigAutoField（而非 AutoField），因为 PostgreSQL 和 MySQL 的默认整型主键在高并发场景下更容易溢出，BigAutoField 更安全，也与 Django 4.2+ 的默认倾向一致。
django-upgrade 工具能自动修复大部分模型语法变动
立即学习“Python免费学习笔记（深入）”；
很多手动改起来费神的点，其实已有成熟工具覆盖。比如：
-
index_together在 4.2 中已彻底移除，必须改用Meta.indexes -
ordering中带连字符的字符串（如'-created_at'）在某些旧写法里会被误解析，新版更严格 -
ForeignKey和OneToOneField的on_delete参数在 2.0 就已是强制项，但 2.2 项目里仍可能漏写，4.2 会直接拒绝启动
运行以下命令可批量修正：
pip install django-upgrade django-upgrade --target-version 4.2 myapp/models.py django-upgrade --target-version 4.2 settings.py它不会动业务逻辑，只改声明式语法；但注意：它不处理自定义 SQL、原生查询或手写的
migrations 文件，这些得人工核对。
psycopg3 成为默认推荐，psycopg2 兼容性需验证
Django 4.2 原生支持 psycopg3（>=3.1.8），且文档明确提示 psycopg2 “将来会被弃用”。升级后若继续用 psycopg2，多数情况能跑，但以下场景容易翻车：
- 使用了
psycopg2.extras.RealDictCursor或自定义适配器的代码，psycopg3接口不兼容 - 数据库连接池（如
pgbouncer）配置未适配psycopg3的新协议行为 -
settings.DATABASES中显式写了'ENGINE': 'django.db.backends.postgresql_psycopg2'—— 这个路径在 4.2 已失效，必须改成'django.db.backends.postgresql'
建议步骤：
- 先保持
psycopg2不变，确保基础功能通过 - 再单独升级
psycopg3，并检查所有涉及cursor、execute、connection的地方 - 若用
django-environ或类似库解析数据库 URL，确认其输出的ENGINE值仍是postgresql（不是postgresql_psycopg2）
STORAGES 替代了旧的文件存储配置，DEFAULT_FILE_STORAGE 仍可用但被标记为 legacy
Django 4.2 引入了统一的 STORAGES 设置，用于管理多个存储后端：
STORAGES = {
"default": {
"BACKEND": "django.core.files.storage.InMemoryStorage",
},
"staticfiles": {
"BACKEND": "django.contrib.staticfiles.storage.StaticFilesStorage",
},
}
- 原来的 DEFAULT_FILE_STORAGE 和 STATICFILES_STORAGE 没被删除，但官方文档已标注为 “legacy”，未来版本会移除
- 如果项目用了自定义存储（如阿里云 OSS、AWS S3），必须迁移到 STORAGES["default"]["BACKEND"] 形式，否则 collectstatic 或文件上传可能静默失败
- 第三方存储包（如 django-storages）4.0+ 版本才完整支持 STORAGES，旧版会忽略该配置
最容易被忽略的是：迁移后没删掉旧配置，导致新旧配置共存，引发难以复现的存储行为不一致。务必确认 settings.py 中只保留一种风格。
