Psycopg3无client_encoding仍报错，Windows下如何适配UTF-8？

核心问题分析 #

你的问题本质是：数据库编码为WIN1252，Windows系统默认控制台编码为cp1252，Psycopg3在Windows环境下可能优先继承系统编码，忽略连接时指定的client_encoding参数，导致包含特殊字符（如\u202f）的参数无法正确编码。

具体解决办法 #

1. 通过连接options强制设置编码 #

Psycopg3虽移除了set_client_encoding，但可通过连接参数options直接向PostgreSQL服务器发送编码设置指令，优先级高于连接参数里的client_encoding：

conn = psycopg.connect(
    dbname="你的数据库名",
    user="你的用户名",
    password="你的密码",
    host="你的主机地址",
    options="-c client_encoding=UTF8"
)

这种方式能确保客户端与服务器之间强制使用UTF-8通信。

2. 修改Python进程默认编码 #

Windows下Python默认编码可能为cp1252，可在代码开头全局设置UTF-8编码，避免字符串处理时使用系统默认编码：

import sys
sys.stdout.reconfigure(encoding='utf-8')
sys.stderr.reconfigure(encoding='utf-8')

配合连接的编码设置，双重规避编码冲突。

3. 显式转换参数编码（兜底方案） #

若上述方法无效，可在执行SQL前，将含特殊字符的字符串参数显式转为UTF-8字节串后传递：

# 遍历参数列表，对字符串类型进行编码转换
encoded_params = [p.encode('utf-8') if isinstance(p, str) else p for p in params]
cur.execute(query, encoded_params)

该方法适合局部特殊场景，需逐个处理参数。

4. 修改数据库编码（长期根治方案） #

若允许调整数据库配置，可将数据库编码改为UTF-8，从根源解决跨平台编码冲突：

1. 备份现有数据库数据
2. 创建新的UTF-8编码数据库：

CREATE DATABASE new_db WITH ENCODING 'UTF8' LC_COLLATE 'en_US.UTF-8' LC_CTYPE 'en_US.UTF-8' TEMPLATE template0;

3. 将原数据库数据迁移至新库

这种方式能统一Linux和Windows下的编码环境，避免后续同类问题。

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