Django 4.2不是小升级，而是结构性调整：必须处理中间件同步/异步分离、显式设置DEFAULT_AUTO_FIELD、迁移至STORAGES配置、适配psycopg3四大硬性改动。
直接说结论：Django 4.2 不是“小升级”，而是对异步、数据库底层、安全机制和配置体系的一次结构性调整；如果你的项目还在用 3.2，升级到 4.2 不能只改版本号，必须处理中间件签名、DEFAULT_AUTO_FIELD、STORAGES 配置、psycopg3 兼容性这四类硬性改动。
中间件必须区分同步/异步调用路径
Django 3.2 的中间件靠 __call__ 统一处理所有请求；到了 4.2，框架会根据视图是否为 async 自动选择调用 __call__ 或 __acall__。没加 __acall__ 的中间件在遇到异步视图时不会报错，但会被强制降级为同步执行——这可能卡住 ASGI 事件循环，导致并发性能断崖式下跌。
- 纯同步中间件：保留
__init__(self, get_response)和__call__(self, request)，不加__acall__也行，但要确保它从不被放进异步上下文 - 想支持异步：必须显式实现
__acall__(self, request)，且内部要用await get_response(request)，不能直接调用get_response(request) - 常见踩坑点：
response = get_response(request); response.content这种写法在 4.2 下遇到异步请求会抛TypeError: object Awaitable can't be used as iterable
数据库与 ORM 层的强制变更项
升级后最常触发的不是报错，而是警告或静默行为变化。比如 models.W042 警告（没设 DEFAULT_AUTO_FIELD）会一直出现在每次 makemigrations 输出里，而 psycopg2 引擎路径 'django.db.backends.postgresql_psycopg2' 在 4.2 中已失效，必须改成 'django.db.backends.postgresql'。
-
DEFAULT_AUTO_FIELD必须在settings.py顶部显式声明，推荐用'django.db.models.BigAutoField'，避免主键溢出风险 - 第三方库若依赖
psycopg2.extras.RealDictCursor或自定义适配器，升级后大概率报AttributeError，需对照 psycopg3 文档重写 -
index_together已彻底移除，必须迁移到Meta.indexes，否则makemigrations会失败
文件存储与缓存中间件顺序更严格
Django 4.2 把 STORAGES 配置设为首选项，同时废弃了 DEFAULT_FILE_STORAGE 和 STATICFILES_STORAGE；更重要的是，LocaleMiddleware 和缓存中间件的相对位置不再是可选优化，而是强制要求——如果启用了 UpdateCacheMiddleware，LocaleMiddleware 必须排在它前面，否则语言切换可能失效。
立即学习“Python免费学习笔记（深入）”；
- 旧配置中的
DEFAULT_FILE_STORAGE = 'myapp.storage.MyStorage'要改为STORAGES = {'default': {'BACKEND': 'myapp.storage.MyStorage'}} -
MIDDLEWARE列表中，'django.middleware.locale.LocaleMiddleware'必须出现在'django.middleware.cache.UpdateCacheMiddleware'之前，顺序颠倒会导致缓存键未包含语言标识 -
InMemoryStorage类可用于测试加速，但它不持久，别误用于生产环境
GZipMiddleware 加入 BREACH 缓解，但影响压缩确定性
4.2 的 GZipMiddleware 默认会在 gzip 响应体中插入最多 100 字节随机填充，以干扰基于压缩比的旁路攻击（BREACH）。这个改动让响应体不再完全确定——相同请求两次返回的 gzip 流长度可能不同，对依赖响应哈希或字节精确比对的测试会造成干扰。
- 若你有自动化测试校验响应二进制一致性，需要禁用该特性：
GZIP_BREACH_PROTECTION = False - 该保护默认开启，无需额外配置，但要注意 CDN 或反向代理是否对随机填充做额外处理
- 它不影响功能逻辑，只改变响应体字节序列，对前端无感知
真正卡住升级的往往不是语法错误，而是那些“运行正常但行为已变”的点：比如 append_slash=True 在 4.2 下不再匹配重定向路径，或者 get_response(request) 返回类型在混合上下文中突然变成 Awaitable。这些地方不报错，但会让线上表现和本地开发不一致。
