Python3 CGI脚本中非ASCII字符解码异常问题求助

这个问题的核心在于CGI环境中Python标准输出的默认编码与命令行环境不同。

当你在bash里直接运行脚本时，Python会自动继承终端的编码（通常是UTF-8），所以打印包含非ASCII字符的字符串'Chloë'时能正常编码输出。但在CGI环境下，Web服务器（比如Apache）启动Python进程时，默认locale往往是C（ASCII编码）——这时候Python尝试用ASCII编码输出'Chloë'里的ë字符，会直接抛出UnicodeEncodeError错误。而CGI环境通常会静默这类错误，导致脚本在出错位置终止，最后一行解码后的内容自然无法输出。

你可以通过两种方式快速解决这个问题：

方法1：显式设置标准输出编码（推荐） #

在脚本开头添加代码，强制将标准输出的编码设为UTF-8（适配Python 3.7+）：

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

print("Content-Type: text/plain; charset=utf-8")
print("Access-Control-Allow-Origin: *")
print()
x = 'Chloë'.encode()
print(x)
print(x.decode())

方法2：手动编码字符串后输出 #

如果需要兼容更早的Python版本，可以直接将字符串编码为UTF-8字节，写入标准输出的buffer：

import sys

print("Content-Type: text/plain; charset=utf-8")
print("Access-Control-Allow-Origin: *")
print()
x = 'Chloë'.encode()
print(x)
# 手动编码为UTF-8并写入，绕开默认编码限制
sys.stdout.buffer.write(x.decode().encode('utf-8') + b'\n')

你可以在脚本中添加错误捕获，确认问题根源：

import sys
try:
    print("Content-Type: text/plain; charset=utf-8")
    print("Access-Control-Allow-Origin: *")
    print()
    x = 'Chloë'.encode()
    print(x)
    print(x.decode())
except Exception as e:
    # 将错误写入stderr，Web服务器的错误日志会记录详情
    print(f"Error: {e}", file=sys.stderr)

查看Web服务器的错误日志，应该能看到类似UnicodeEncodeError: 'ascii' codec can't encode character '\xeb' in position 4: ordinal not in range(128)的报错，这就能验证我们的判断。

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