Django 3.2.x Documentation

《Django 3.2.x Documentation》摘要 本文档主要涵盖了Django 3.2.x版本的相关内容，包括新功能、回溯性变化、已知问题、安全修复以及版本更新的详细信息。以下是核心内容的总结： --- ### 1. **关于本版本** - **Django 3.2** 是一个长期支持版本（LTS），直到 October 2024 支持。 - 适用于生产环境，是Django 3.2.x系列的最新版本。 --- ### 2. **关键更新与新功能** - **PostgreSQL支持**：Django 3.2支持PostgreSQL 9.6及更高版本，不再支持PostgreSQL 9.5。 - **MySQL支持**：Django 3.2支持MySQL 5.7及更高版本，不再支持MySQL 5.6。 - **时区支持**：新增对非pytz时区（如Python 3.9+的zoneinfo模块）的支持。 - **性能改进**：优化了复杂查询的子查询生成，修复了与多值关系相关的查询问题。 - **注意事项**： - 生成URL时，`gone` 状态码改为 `410` 代替 `301`。 - 垃圾邮件检测逻辑已更改。 --- ### 3. **已知问题与修复** 以下是Django 3.2版本中已知的关键问题及修复内容： -修复了在PostgreSQL上使用`dbshell`命令时未传递环境变量的问题。 -修复了模板渲染时变量查找错误日志的问题。 -修复了由于区分(distinct)后无法调用`delete()`方法的问题。 -解决了在Conda环境中自动刷新器（auto-reloader）导致的`AttributeError`问题。 -修复了与`mod_wsgi`和`colorama`库同时使用时的崩溃问题。 -修复了`DecimalField`在MySQL上的精度损失问题。 --- ### 4. **回溯性变化与废弃内容** - **已删除功能**： - `urlquote()`、`urlquote_plus()`、`urlunquote()`、`urlunquote_plus()` 已移除。 - `force_text()` 和 `smart_text()` 已移除。 - `ugettext()`、`ugettext_lazy()` 等相关函数已移除。 - `memcached`缓存后端支持已移除。 - `messages`模块中对旧格式消息的支持已移除。 - **行为变化**： - `TransactionTestCase.assertQuerysetEqual()` 不再自动调用`repr()`。 - `Testcase.setUpTestData()` 不再支持无法进行深拷贝的对象。 --- ### 5. **安全修复** 以下是Django 3.2.x版本中修复的安全问题： - **CVE-2022-23833**：文件上传可能导致拒绝服务（DoS）。 - **CVE-2021-45452**：`Storage.save()` 存在路径遍历漏洞。 - **CVE-2021-45116**：`dictsort` 模板过滤器可能导致信息泄露。 - **CVE-2021-45115**：`UserAttributeSimilarityValidator` 存在拒绝服务可能性。 --- ### 6. **性能与优化** - 优化了子查询生成逻辑，提升了复杂查询性能。 - 修复了与多关系exclude()操作相关的问题。 - 缓存键在相关设置下不再包含语言信息。 --- ### 7. **其他重要提示** - 使用`setup_databases()`时，关键字参数需以关键字形式传递。 -CultureDotNet_warning部分已移除。 - 某些后端默认配置改为更安全的选项。 --- 本文档为开发者提供了关于Django 3.2.x版本的全面信息，特别是升级和迁移过程中需要注意的回溯性变化和安全修复内容。