为法国公司搭建Django应用时iso-8859-1编码报错求解决

问题根源 #

报错中的\u2019是智能右单引号（’），该字符不在iso-8859-1（latin-1）的字符集范围内（latin-1仅包含0-255的字符）。你提到的système本身没问题（è属于latin-1字符），但模板中可能混入了这类智能引号或其他超出latin-1范围的扩展字符。

具体解决步骤 #

1. 清理模板中的非latin-1字符 #

直接检查并替换模板里的违规字符：

• 将智能引号（’）替换为普通单引号（'），排查所有类似的特殊字符（比如智能双引号“”）。
• 用文本编辑器开启「显示不可见字符」功能，定位所有超出latin-1范围的字符并替换。

2. 确保模板文件以iso-8859-1编码保存 #

• 在编辑器中设置模板文件的编码为ISO-8859-1（而非UTF-8），避免保存时引入隐形的非兼容字符。
• 例如VS Code可通过右下角的编码选择器切换，重新保存文件。

3. 添加编码容错中间件（可选） #

如果无法完全规避非latin-1字符，可通过自定义中间件处理编码错误：
在项目目录下创建middleware.py，写入以下代码：

from django.utils.deprecation import MiddlewareMixin

class EncodeErrorMiddleware(MiddlewareMixin):
    def process_response(self, request, response):
        if isinstance(response.content, str):
            try:
                response.content = response.content.encode('iso-8859-1')
            except UnicodeEncodeError:
                # 将无法编码的字符替换为?，也可指定其他latin-1兼容字符
                response.content = response.content.encode('iso-8859-1', errors='replace')
        return response

然后在settings.py的MIDDLEWARE列表中添加该中间件：

MIDDLEWARE = [
    # 其他中间件...
    '你的项目名.middleware.EncodeErrorMiddleware',
]

4. 完善Django编码配置 #

确认settings.py中的编码配置无遗漏：

FILE_CHARSET = 'iso-8859-1'
DEFAULT_CHARSET = 'iso-8859-1'
# 若使用数据库，需同步设置数据库连接编码
DATABASES = {
    'default': {
        # 其他数据库配置...
        'OPTIONS': {
            'charset': 'latin1',
        },
    }
}

内容的提问来源于stack exchange，提问作者Charbel Nasr