生产环境上传希腊语文件名乱码问题（本地环境正常）

安全阿岳

2026-7-22

生产环境希腊语文件名乱码问题排查与解决

核心原因分析

乱码本质是生产环境的编码链路存在不一致：UTF-8编码的希腊语文件名被错误解析为单字节编码（如ISO-8859-1）后再次转码，导致显示异常。本地环境全链路编码统一为UTF-8，因此无问题；数据库无乱码是因为数据库连接层已单独设置UTF-8编码，与文件上传的系统/PHP编码链路是独立环节。

具体排查与修复步骤

检查服务器系统Locale设置
生产环境服务器（尤其是Linux）默认字符集可能非UTF-8。执行命令locale查看，确保LC_ALL、LC_CTYPE、LANG均为en_US.UTF-8或其他UTF-8类型的locale。若不符，修改系统locale配置（如编辑/etc/locale.conf）并生效。

核对PHP编码配置
检查生产环境php.ini，确保以下配置正确：

default_charset = "UTF-8"
mbstring.internal_encoding = UTF-8
mbstring.http_input = UTF-8
mbstring.http_output = UTF-8

修改后重启PHP-FPM或Web服务器。

确认Scriptcase框架编码配置
在Scriptcase项目全局设置中，将字符编码选项强制设为UTF-8；同时检查上传组件的单独编码配置，确保同步使用UTF-8处理文件名。

手动干预文件名编码转换
在调用sc_api_download前，显式将文件名转为UTF-8，避免环境自动转码错误：

// 根据Scriptcase返回的$usersFile结构，调整name字段的获取方式
$usersFile['name'] = mb_convert_encoding($usersFile['name'], 'UTF-8', mb_detect_encoding($usersFile['name']));

sc_api_download([
    'settings' => [
        'gateway' => 'dropbox',
        'api_key' => {apikey},
        'api_secret' => {apisecret},
        'access_token' => {accesstoken},
    ],
    'file' => $usersFile,
    'destination' => 'tmp/files/',
]);