psql报错UTF8字节序列无WIN1252等效字符切换编码无效如何解决

问题现象 #

• 常规操作无规律触发报错：输入未闭合括号、执行DROP TABLE book;这类基础语句时都会抛出异常
• 初始报错内容：

ERROR:  character with byte sequence 0xd0 0x9e in encoding "UTF8" has no equivalent in encoding "WIN1252"

• 参照网传方案直接执行\encoding UTF8切换客户端编码无效，切换后返回乱码报错：

DzD"D~D`DsD?:  D_Ñ^D,D±DºD° Ñ?D,D½Ñ,D°DºÑ?D,Ñ?D° (D¿Ñ?D,D¼DµÑ?D½D_Dµ D¿D_D»D_D¶DµD½D,Dµ: ")") LINE 1: ); ^

根本原因 #

报错本质是三层编码设置不匹配：

• PostgreSQL服务端生成的报错提示为UTF8编码，其中字节序列0xd0 0x9e是西里尔大写字母Ю的UTF8编码
• psql客户端默认配置使用WIN1252（西欧拉丁字符集）做转码，该字符集没有对应西里尔字符的映射，因此抛出编码不匹配错误
• 仅执行\encoding UTF8只修改了psql客户端自身的编码参数，没有同步修改Windows控制台的输入输出代码页，控制台仍按WIN1252规则解析UTF8格式的字节流，必然出现乱码。

分步解决方法 #

临时快速修复 #

1. 不要直接打开psql的SQL Shell快捷方式，先打开cmd命令提示符，执行命令切换当前控制台的代码页为UTF8：

   chcp 65001
   

2. 在当前cmd窗口中直接输入psql -U 你的用户名 -d 你的数据库名连接数据库，连接后执行命令确认客户端编码：

   \encoding UTF8
   

3. 执行校验命令确认配置生效：
   • 执行\! chcp，返回结果显示活动代码页: 65001即为控制台配置正确
   • 执行show client_encoding;，返回结果为UTF8即为psql客户端配置正确
     三层编码对齐后，执行SQL、触发报错时都不会再出现编码异常或乱码。

永久生效配置 #

• 配置psql默认编码：打开路径%APPDATA%\postgresql\，如果路径下没有psqlrc.conf文件就新建一个，在文件内添加一行配置：

  \encoding UTF8
  

• 修改SQL Shell快捷方式参数：右键点击平时使用的SQL Shell快捷方式，选择「属性」，在「目标」输入框原有内容的最前方添加cmd /c chcp 65001 && ，例如原有目标为"C:\Program Files\PostgreSQL\16\bin\psql.exe" -h localhost -U postgres，修改后为：

  cmd /c chcp 65001 && "C:\Program Files\PostgreSQL\16\bin\psql.exe" -h localhost -U postgres
  

  注意：修改时不要删除原有psql的启动路径和连接参数，否则会导致快捷方式无法正常启动程序
  保存设置后，后续双击快捷方式打开会自动切换控制台代码页，无需每次手动执行命令。

避坑说明 #

• 不要仅修改psql客户端编码、不调整控制台代码页：两者编码不一致时必然出现转码错误或乱码
• 如果你的系统区域设置为俄语等西里尔语系，也可以选择匹配WIN1251编码：控制台执行chcp 1251，psql内执行\encoding WIN1251，只要保证控制台代码页、psql客户端编码、服务端输出编码三者完全匹配，就不会出现编码问题。

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