Python连接PostgreSQL遇UnicodeDecodeError，如何处理编码问题？

这个错误是因为连接参数（比如密码、用户名）包含非UTF-8编码的字符，或者客户端与数据库服务端的字符集不匹配导致的。下面是具体解决办法：

一、通过修改字符编码解决 #

1. 连接时指定客户端编码 #

在psycopg2连接时直接添加client_encoding参数，根据实际字符集调整（比如GBK、UTF8）：

conn = psycopg2.connect(
    dbname=database,
    user=user,
    host=host,
    port=port,
    password=passw,
    client_encoding='GBK'
)

用SQLAlchemy的话，在连接URL里追加编码参数：

engine = create_engine(f'postgresql://{user}:{passw}@{host}:{port}/{database}?client_encoding=GBK')

2. 统一连接参数的编码格式 #

如果你的密码或用户名包含非ASCII字符，先把参数转为UTF-8编码的字符串：

# 假设原参数是GBK编码，转成UTF-8
passw = passw.encode('gbk').decode('utf-8')
# 如果本身应该是UTF-8，直接确保格式正确
passw = passw.encode('utf-8').decode('utf-8')

二、不建议忽略该错误 #

强行忽略错误（比如用errors='ignore'解码）会导致连接参数丢失部分字符，大概率引发登录失败，后续操作还可能出现乱码、数据损坏，绝对不推荐这么做。

额外排查点 #

• 查数据库服务端编码：执行SHOW server_encoding;，确保客户端编码和服务端编码兼容
• 确认Python脚本文件编码是UTF-8，可在文件开头加# -*- coding: utf-8 -*-

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