drupal中文乱码异常自助排查手册

判断「drupal中文」是否合适,关键在于先确认它解决的是哪一类具体问题;与相近方案的核心区别在于适用条件不同。它与相近方案的区别在于:前者强调可验证的依据,后者更依赖经验判断,混用容易得出偏差结论。

最常见的三个原因

以下概率基于排障工单统计,实际以你站点的环境为准。

数据库字符集未统一

高 40%

MySQL 建库时用了 latin1,Drupal 存中文时就会静默损坏。特征是所有中文站点同时出问题,且从数据库直接查也是乱码。

语言包版本不匹配

中 30%

中文语言包需要对应 Drupal 版本,旧版 zh-hant/zh-cn 包在新核心上会丢失翻译字符串,表现是界面中文但内容英文。

服务器编码未设为 UTF8

低 30%

PHP 的 default_charset、Apache 的 AddDefaultCharset 或 Nginx 配置层没统一,请求到服务器的数据会被二次编码。

症状索引表

症状最可能原因跳到哪一节
中文显示为方框或问号数据库字符集中文内容乱码
菜单/标题中文消失语言包不匹配中文菜单异常
上传中文文件名失败服务器编码层中文附件上传失败
中文 URL 打不开URL 路由转码中文 URL 路由错误

中文内容乱码

现象:文章内容、用户昵称、分类标签出现 ???、方框或不可读字符,但英文内容正常。

30 秒快速验证:进入后台 管理 > 报告 > 状态报告,找到 "数据库" 一栏,查看 Collation 是否为 utf8mb4_unicode_ci。

验证成立:在 phpMyAdmin 执行 ALTER DATABASE 库名 DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;,然后重建全站缓存。

处理不了:说明不是数据库层问题,而是 PHP 或应用层在写数据时已截断,需要查 php.ini 的 default_charset 设定值。

中文菜单异常

现象:导航菜单标题部分显示为英文,或整个菜单块为空,但内容页中文正常。

30 秒快速验证:进入 管理 > 设置 > 语言,确认语言包版本与当前 Drupal 核心版本一致,且启用状态为 "启用"。

验证成立:去 模块管理 重新下载对应版本的中文语言包,覆盖安装后清除缓存。

处理不了:可能是自定义菜单通过 API 输出未编码,需检查自己的模块或主题代码中是否有 iconv 转码逻辑。

中文附件上传失败

现象:上传含中文文件名的图片或附件时提示失败,或上传成功后文件名被替换为随机字符串。

30 秒快速验证:打开 管理 > 配置 > 文件系统,检查 "默认文件目录" 路径中是否混入了非 UTF8 字符,以及 PHP 的 file_uploads 设置。

验证成立:把路径改为纯英文,并在 settings.php 添加 $conf['file_uploads'] = TRUE; 确保路径编码一致。

处理不了:可能是服务器文件系统不支持中文路径(如 Ext3 格式),需联系主机商确认编码环境。

中文 URL 路由错误

现象:文章 URL 中的中文标题生成后被转码为 %E4%B8%AD 文,直接访问返回 404。

30 秒快速验证:新建一篇纯中文标题的文章,发布后点击查看,观察 URL 中中文是否被保留为 UTF8 编码。

验证成立:在 管理 > 设置 > 搜索引擎和元数据 中关闭 "自动转码 URL" 选项,或安装 Pathauto 插件统一规则。

处理不了:说明服务器重写规则(.htaccess 或 nginx config)不处理中文路径,需修改服务器配置。

判断线:该修还是该换

当出现以下情况,优先尝试修复:

当出现以下情况,考虑迁移站点或更换环境:

判断线:中文问题 80% 出在配置层,50% 的修复在 30 秒内可以完成验证。

容易误判的情况

看着像 A 其实是 B,区分方法如下。

误判 1:以为是中文乱码,其实是浏览器的字符集设为 GBK。区别:按 F12 看 Network 里 response 的 Content-Type,如果写着 GB2312 就是服务器没发 UTF8。

误判 2:以为是数据库问题,其实是主题模板写死了英文硬编码。区别:切换回默认主题 Bartik,中文异常消失则说明责任在主题代码。

预防措施

建站初期做好以下设定,可减少 70% 的中文问题:

定期检查:每季度跑一次 管理 > 报告 > 安全,查看是否有编码相关的警告项。中文内容占比高的站点,建议在数据库层保留一份 GBK 备份用于比对。

需要求助时要准备的信息

去官方论坛或社区提问前,准备好以下内容,否则会被要求补信息:

说明你已尝试的步骤和验证结果,这能节省 50% 的沟通时间。定位问题靠证据,不靠描述。

常见问题

为什么升级后中文全丢了?

升级过程中如果数据库 Collation 未被正确迁移,新核心写入时会将旧数据视为乱码。先确认数据库结构是否完整,再考虑是否回滚到升级前的版本。

中文插件启用后网站变白了吗?

是的,通常是因为语言包与核心版本不兼容。去下载页核对版本矩阵,再重新安装对应版本的中文语言包。

缓存清不掉中文异常怎么办?

清缓存只能解决显示层问题。如果数据库层编码错误,清缓存不会改变数据。先修复数据库,再走 清除所有缓存。