使用psycopg2连接PostgreSQL时触发UnicodeDecodeError，全链路UTF-8编码配置下仍无法解决

阿华AIGC实验室

2026-4-7

这种情况真的挺闹心的——之前一切正常，突然断电后就冒出这种摸不着头脑的编码错误，明明全链路都配置成UTF-8了却还是触发UnicodeDecodeError。我来帮你梳理下可能的原因和排查方向：

先拆解下错误里的关键信息

你遇到的0xe9字节其实很有指向性：这个字节在**Latin-1（ISO-8859-1/Windows-1252）**里是法语常用的字符é，但在UTF-8编码中，它并不是一个合法的续字节（UTF-8的é应该是0xc3 0xa9两个字节）。错误提示说它出现在解码的续字节位置，说明有某个环节把Latin-1编码的字节流当成UTF-8来解码了——这和你看到的“全链路UTF-8”表面矛盾，但结合你的场景，大概率是突然断电导致某个配置/文件损坏，或者系统环境的隐性编码设置在作祟。

结合你的Windows 11法语系统，这些排查方向可以试试：

1. 检查系统命令行的默认代码页

法语Windows默认的命令行代码页是1252（对应Latin-1变体），虽然你的代码参数是UTF-8，但psycopg2可能在读取系统环境变量或本地配置时，误把系统代码页当成了编码基准。

打开命令行（CMD或PowerShell），输入chcp，看输出的代码页是65001（UTF-8）还是1252；
如果是1252，先临时切换到UTF-8：输入chcp 65001，然后再运行你的测试代码，看是否还报错；
如果临时切换后问题解决，可以设置命令行默认使用UTF-8：Windows设置→时间和语言→语言和区域→其他日期、时间和区域设置→更改日期、时间或数字格式→管理→更改系统区域设置→勾选“Beta版：使用Unicode UTF-8提供全球语言支持”，重启电脑后生效。

2. 重新安装psycopg2，修复可能损坏的依赖文件

突然断电可能导致Python的site-packages里的psycopg2二进制文件损坏——毕竟二进制文件对意外中断更敏感。

卸载现有版本：

pip uninstall -y psycopg2 psycopg2-binary

重新安装官方推荐的二进制包：
```
pip install psycopg2-binary
```

3. 强制指定psycopg2的客户端编码

虽然你用SHOW client_encoding看到是UTF8，但可以在代码里显式指定编码，绕过可能的隐性配置：

普通Python脚本里可以修改params：

params = {
    'dbname': 'database_name',
    'user': 'user_name',
    'password': 'mypassword',
    'host': 'localhost',
    'options': '-c client_encoding=utf8'
}

如果是Django项目，在settings.py的数据库配置里加OPTIONS：

DATABASES = {
    'default': {
        # 其他配置...
        'OPTIONS': {
            'client_encoding': 'utf8',
        },
    }
}

4. 检查PostgreSQL的配置文件与数据库完整性

突然断电可能损坏PostgreSQL的配置文件或数据库元数据：

找到PostgreSQL的postgresql.conf文件（通常在data目录下），确认server_encoding = UTF8和client_encoding = UTF8（如果被注释了也没关系，默认就是UTF8，但要确保没有被改成其他值）；
重启PostgreSQL服务（Windows服务里找到PostgreSQL，右键重启）；
用PostgreSQL自带的pg_checkdb工具检查数据库是否有损坏：
1. 先停掉PostgreSQL服务；
2. 打开命令行，切换到PostgreSQL的bin目录（比如C:\Program Files\PostgreSQL\15\bin）；
3. 运行：
```
pg_checkdb -d database_name
```
4. 如果发现损坏，按照工具提示进行修复（注意：修复前一定要先备份数据库目录！）。