Django所有HTML页面报错均触发同一ascii编码解码异常如何解决

• 报错根因是Python运行时的默认文件编码为ASCII，无法解码Django自带调试模板中的UTF-8字符。从堆栈可以定位到错误出现在django/views/debug.py读取500错误调试模板时执行fh.read()的步骤，Django官方调试模板中包含长破折号、智能引号等特殊UTF-8字符（对应字节以0xe2开头），ASCII解码器无法处理这类字符就会抛出该异常。
• 即便项目自身代码仅包含拉丁字符，只要触发服务端错误需要返回调试页面，就会触发该异常，覆盖原始的错误信息。
• 该问题通常由运行环境的locale配置错误导致，尤其是你使用Channels作为ASGI服务时，启动进程的环境中LANG、LC_ALL等编码相关变量未设置为UTF-8格式，就会导致Python默认使用ASCII作为文件读取编码。

先做临时验证：在启动Django服务的终端执行以下命令，再重启服务验证问题是否解决：

export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8
export LC_LANG=en_US.UTF-8

如果验证生效，根据你的使用场景选择对应的永久修复方案：

• 本地开发场景
  • Mac/Linux：在shell配置文件（~/.bashrc、~/.zshrc等）末尾添加上述3条export语句，保存后执行source 对应配置文件路径永久生效。
  • Windows：在系统环境变量页面新增上述3个变量，取值均为en_US.UTF-8，重启终端/IDE后生效。
• 生产部署场景
  • 若使用systemd管理服务：在对应service配置文件的[Service]段添加如下配置，重载systemd配置后重启服务即可：

    Environment="LANG=en_US.UTF-8"
    Environment="LC_ALL=en_US.UTF-8"
    

  • 若使用Docker部署：在Dockerfile中添加如下环境变量配置，重新构建镜像即可：

    ENV LANG en_US.UTF-8
    ENV LC_ALL en_US.UTF-8
    

• 兼容兜底方案
  如果修改环境变量无法生效，可以在项目的asgi.py（因为你用了Channels走ASGI协议）文件最开头添加如下代码，强制指定Python默认编码：

import _locale
_locale._getdefaultlocale = lambda *args: ('en_US', 'UTF-8')

内容的提问来源于stack exchange，提问作者Eduard Kumskyi