Python 3.9 Django 2.2部署时Encoding报错怎么修复？

修复 Python 3.9 与 Django 2.2 部署时的 Encoding 报错，最推荐的处理方向是统一系统环境变量为 UTF-8 并检查数据库连接配置，适用场景为 Linux 服务器部署或 Docker 容器环境，最重要的风险边界是修改系统 Locale 可能影响其他旧程序运行。

先说结论：Encoding 报错通常由系统默认编码与 Python 代码或数据库字符集不一致导致，优先检查服务器 Locale 设置和 Django 数据库配置。

先确认：使用 locale 命令查看当前系统编码是否为 UTF-8。
先处理：在启动脚本或 Dockerfile 中强制设置 LANG 环境变量为 C.UTF-8。
再验证：运行 python manage.py check 确认无报错且日志正常输出中文。

命令速用版

在服务器终端执行以下命令临时修复环境变量，适用于快速验证问题来源。

export LANG=C.UTF-8
export LC_ALL=C.UTF-8
python manage.py runserver

若需永久生效，将上述 export 命令写入 ~/.bashrc 或 Dockerfile 的 ENV 指令中。

为什么会这样

Encoding 报错的根本原因是运行环境的默认字符集无法解析代码或数据中的非 ASCII 字符。Python 3 默认源文件编码为 UTF-8，但 Linux 最小化安装或某些 Docker 基础镜像的系统 Locale 默认为 ASCII 或 POSIX。当 Django 尝试读取包含中文的文件、记录日志或连接数据库时，若环境未声明 UTF-8 支持，就会触发 UnicodeDecodeError 或数据库乱码。

分步处理

按顺序执行以下步骤，每一步完成后检查报错是否消失。

步骤 1：检查系统 Locale 设置

在终端输入 locale 命令，查看输出中 LANG 和 LC_ALL 的值。若显示 POSIX 或 empty，说明系统未启用 UTF-8。

步骤 2：配置环境变量

在部署脚本、systemd 服务文件或 Dockerfile 中添加环境变量。Docker 示例如下：

ENV LANG=C.UTF-8
ENV LC_ALL=C.UTF-8

若是 systemd 管理的服务，在 Service 段落添加 Environment="LANG=C.UTF-8"。

步骤 3：检查 Django 数据库配置

打开 settings.py，确认 DATABASES 配置中指定了 charset。MySQL 示例如下：

'OPTIONS': {
    'charset': 'utf8',
}

步骤 4：检查源代码文件编码

确保所有.py 文件保存为 UTF-8 格式。若使用 Git，检查 .gitattributes 确保未强制转换编码。

怎么验证是否生效

执行 python manage.py check 命令，若返回 System check identified no issues 则基础配置通过。观察部署日志，确认包含中文的日志条目不再显示乱码或报错。访问网站涉及数据库读写的页面，确认中文内容显示正常。

常见坑

Docker 容器内默认 Locale 可能未安装 UTF-8 支持包，需在 Dockerfile 中安装 locales 包并生成 locale。Django 2.2 已停止官方维护，部分新库可能不再兼容，若报错涉及第三方包编码，建议检查该包是否支持 Python 3.9。MySQL 数据库默认字符集若为 latin1，即使 Django 配置 utf8 也可能报错，需在数据库层面修改表字符集。

常见问题

UnicodeDecodeError: 'ascii' codec can't decode byte 怎么修？

这是系统环境变量未设置 UTF-8 导致的，请在启动脚本中添加 export LANG=C.UTF-8。

Django 日志打印中文乱码怎么办？

检查 logging 配置中 Handler 的 encoding 参数，显式指定 encoding='utf-8'。

部署到云服务器后本地正常但报错为什么？

本地开发环境通常默认 UTF-8，而云服务器最小化安装可能默认 ASCII，需统一服务器环境变量。

参考来源

Django 官方文档：Settings 参考 - DEFAULT_CHARSET 及 DATABASES 配置

Python 官方文档：Locale 模块说明及 Unicode 处理指南