Docker部署PostgreSQL后使用Psycopg2连接时出现UTF-8解码错误

我之前也碰到过类似的编码问题，明明各种配置都显示是UTF-8，但就是出现解码失败的报错，确实挺闹心的。结合你的情况，给你几个实际可行的排查和解决方向：

1. 检查Docker容器的系统环境编码 #

虽然PostgreSQL本身设置了UTF-8，但容器的系统环境编码可能没跟上，导致psycopg2和数据库交互时出现编码不兼容的情况。你可以在启动PostgreSQL容器时，添加编码相关的环境变量：

如果是用docker run命令：

docker run -d \
  -e LANG=C.UTF-8 \
  -e LC_ALL=C.UTF-8 \
  # 其他你原本的参数，比如端口映射、卷挂载等
  postgres:你的版本号

如果是用docker-compose，就在配置文件里加上：

services:
  postgres:
    image: postgres:你的版本号
    environment:
      - LANG=C.UTF-8
      - LC_ALL=C.UTF-8
      # 其他环境变量比如POSTGRES_DB、POSTGRES_USER等
    # 其他配置...

添加完后重启容器，再尝试连接。

2. 升级psycopg2到最新版本 #

部分旧版本的psycopg2在处理编码交互时可能存在bug，试试升级到最新版的psycopg2-binary（比源码编译的psycopg2更适合快速测试）：

pip install --upgrade psycopg2-binary

3. 改用DSN字符串方式连接 #

有时候参数式的连接可能会因为隐式的编码转换出问题，试试直接用DSN字符串来建立连接：

import psycopg2

# 用DSN字符串指定所有参数，明确client_encoding
conn = psycopg2.connect("dbname=testdb user=user password=pass host=localhost port=5432 client_encoding=utf8")
conn.close()

4. 针对Windows系统的额外调整 #

Windows的系统编码有时候会影响Python的运行环境，你可以试试：

• 在运行Python脚本前，先在命令行设置环境变量：

set PYTHONIOENCODING=utf-8

然后再执行你的脚本。

• 或者在脚本开头添加编码设置：

import locale
locale.setlocale(locale.LC_ALL, 'en_US.UTF-8')

另外，你也可以进入Docker容器内部，用psql工具连接数据库，执行以下命令确认编码状态：

SHOW server_encoding;
SHOW client_encoding;

如果两者都是UTF-8，再尝试输入一些特殊字符（比如é、中文等）测试，看容器内的编码是否正常工作。

如果以上方法都不行，可以补充一下你的PostgreSQL版本、psycopg2版本、Docker启动命令这些信息，方便进一步排查问题。

备注：内容来源于stack exchange，提问作者Madfouuffe