psql报无效UTF8字节序列：批处理传特殊字符变量失败

方法1：十六进制字节转义法 #

这是最可靠的绕开编码传递问题的方式，步骤如下：

• 生成十六进制字符串：用PowerShell把带特殊字符的字符串转成UTF8十六进制（避免命令行编码干扰），比如处理Müller：

  $str = "Müller"
  $hex = -join ([System.Text.Encoding]::UTF8.GetBytes($str) | ForEach-Object { $_.ToString("X2") })
  $hex
  

  输出结果为 4DC3BC6C6C6572
• SQL文件中解码：在你的SQL脚本里用PostgreSQL的decode()函数把十六进制转回字符串：

  -- 假设传入的变量是customer_hex
  SELECT * FROM customers WHERE name = decode(:customer_hex, 'hex');
  

• 调用psql传递变量：执行psql时直接传十六进制值：

  psql -d 你的数据库名 -v customer_hex=4DC3BC6C6C6572 -f 你的脚本.sql
  

方法2：临时文件读取法 #

如果不想处理十六进制，也可以用文件中转：

• 写入UTF8无BOM临时文件：把带特殊字符的字符串保存为UTF8无BOM格式的临时文件（注意：一定要无BOM，否则psql读取会有问题）：

  # 用PowerShell写入避免编码问题
  powershell -Command "Set-Content -Path temp_customer.txt -Value 'Müller' -Encoding UTF8NoBOM"
  

• SQL文件中读取变量：在SQL脚本里用\set读取文件内容：

  \set customer_name `type temp_customer.txt`
  SELECT * FROM customers WHERE name = :'customer_name';
  

• 清理临时文件：执行完后记得删除临时文件：

  del temp_customer.txt
  

额外建议 #

• 尽量避免在Windows cmd中直接传递带特殊字符的变量，cmd的编码传递机制存在固有兼容性问题，哪怕设置了65001也可能出问题
• 改用PowerShell执行psql命令，PowerShell对UTF8的支持更完善，能减少大部分编码相关的坑

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