Ubuntu下Perl CGI输出UTF-8内容乱码问题求助

问题描述 #

环境：Ubuntu + MySQL + Perl + Apache
问题：写入MySQL的JSON内容显示正常，但浏览器端获取到的内容存在乱码，特殊字符无法正常显示。相关代码片段：

use utf8;
use CGI('-utf8'); #added based on another forum article i was reading.
use Encode;
.....

my $localcontent = JSON->new->utf8->encode($data); 
#i write $localcontent back in mysql and can see that it is good.

print $cgi->header(
    -type          => 'application/json',
    -cookie      => $_sessioncookie,
    -content_length => length($localcontent),
    -charset        => 'UTF-8'
);
Encode::encode( 'UTF-8', $localcontent );
#i also tried binmode for STDOUT (binmode(STDOUT, ':encoding(UTF-8)');) but that gives the same result.

调试方向 #

• 检查输出编码重复处理：JSON->new->utf8->encode($data)已生成UTF-8字节流，后续调用Encode::encode('UTF-8', $localcontent)会对字节流再次编码，引发双重编码乱码。可打印$localcontent的字节长度与字符数，确认是否为UTF-8字节流。
• 验证STDOUT编码状态：使用binmode(STDOUT, ':encoding(UTF-8)')时，若$localcontent已是UTF-8字节流，Perl会把字节流当作字符再次编码，导致乱码。可通过use Devel::Peek; Dump($localcontent);查看变量内部编码状态（字节流/字符字符串）。
• 确认Apache默认输出编码：检查Apache配置文件（如/etc/apache2/apache2.conf或虚拟主机配置）是否设置AddDefaultCharset UTF-8，未设置可能导致浏览器接收到的编码标识不一致。
• 排查浏览器编码解析：在浏览器开发者工具「网络」面板查看响应头Content-Type是否包含charset=UTF-8，同时检查浏览器是否强制使用其他编码解析页面。

正确配置方法 #

代码层面修正 #

1. 生成字符字符串统一输出：去掉JSON的utf8选项生成UTF-8字符字符串，再通过STDOUT编码输出：

# 生成UTF-8字符字符串（内部编码为UTF-8）
my $localcontent = JSON->new->encode($data);
# 设置STDOUT为UTF-8编码输出
binmode(STDOUT, ':encoding(UTF-8)');
print $cgi->header(
    -type          => 'application/json',
    -cookie        => $_sessioncookie,
    -content_length => length($localcontent),
    -charset        => 'UTF-8'
);
print $localcontent;

2. 直接输出字节流：保留JSON生成的UTF-8字节流，不设置STDOUT编码层，也无需再次调用Encode::encode：

my $localcontent = JSON->new->utf8->encode($data);
# 注意：不要设置binmode(STDOUT, ':encoding(UTF-8)')
print $cgi->header(
    -type          => 'application/json',
    -cookie        => $_sessioncookie,
    -content_length => length($localcontent),
    -charset        => 'UTF-8'
);
print $localcontent;

数据库与Apache配置补充 #

• MySQL连接编码：Perl连接MySQL时，使用DBI需添加mysql_enable_utf8 => 1或mysql_enable_utf8mb4 => 1参数，确保数据库读写时编码一致。
• Apache编码配置：在Apache配置中添加AddDefaultCharset UTF-8，确保所有响应默认使用UTF-8编码，避免浏览器自动猜测编码导致乱码。

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