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)不处理中文路径,需修改服务器配置。
判断线:该修还是该换
当出现以下情况,优先尝试修复:
- 网站整体可访问,仅中文内容异常
- 错误出现在数据库或缓存层,而非服务器底层
当出现以下情况,考虑迁移站点或更换环境:
- 数据库 Collation 为 latin1 且数据量超过 10 万条,修复成本高于迁移
- 语言包与核心版本跨度超过一个大版本,API 不兼容
判断线:中文问题 80% 出在配置层,50% 的修复在 30 秒内可以完成验证。
容易误判的情况
看着像 A 其实是 B,区分方法如下。
误判 1:以为是中文乱码,其实是浏览器的字符集设为 GBK。区别:按 F12 看 Network 里 response 的 Content-Type,如果写着 GB2312 就是服务器没发 UTF8。
误判 2:以为是数据库问题,其实是主题模板写死了英文硬编码。区别:切换回默认主题 Bartik,中文异常消失则说明责任在主题代码。
预防措施
建站初期做好以下设定,可减少 70% 的中文问题:
- 建库时强制指定 utf8mb4,不要用默认值
- PHP 的 default_charset 设为 UTF8
- 选择与核心版本严格匹配的语言包
定期检查:每季度跑一次 管理 > 报告 > 安全,查看是否有编码相关的警告项。中文内容占比高的站点,建议在数据库层保留一份 GBK 备份用于比对。
需要求助时要准备的信息
去官方论坛或社区提问前,准备好以下内容,否则会被要求补信息:
- 版本:Drupal 核心版本号、PHP 版本、MySQL 版本,在状态报告页面可找到
- 日志:打开 管理 > 报告 > 最近的事件,截图报错条目
- 截图要点:包含乱码的完整页面、数据库 Collation 设置页、settings.php 的关键配置段
说明你已尝试的步骤和验证结果,这能节省 50% 的沟通时间。定位问题靠证据,不靠描述。
常见问题
为什么升级后中文全丢了?
升级过程中如果数据库 Collation 未被正确迁移,新核心写入时会将旧数据视为乱码。先确认数据库结构是否完整,再考虑是否回滚到升级前的版本。
中文插件启用后网站变白了吗?
是的,通常是因为语言包与核心版本不兼容。去下载页核对版本矩阵,再重新安装对应版本的中文语言包。
缓存清不掉中文异常怎么办?
清缓存只能解决显示层问题。如果数据库层编码错误,清缓存不会改变数据。先修复数据库,再走 清除所有缓存。
