迅睿CMS留言乱码修复踩坑记！看完这篇一键搞定不头大

家人们谁懂啊！上周刚把公司小官网从别的野鸡CMS换成朋友墙裂推的「性价比卷王天花板」迅睿CMS，刚发完第一条产品预告准备蹲流量，后台直接炸锅——三条中文留言全是「??????」「????????」「???????????」，连表情都是方块儿，像极了我当年追韩综啃生肉看到韩语字幕卡bug的崩溃现场！

以为是浏览器抽风的我，疯狂刷新换了五个浏览器，又让在北京上海深圳的死党全测了一遍，结果都是“鬼画符集中营”。找了官方免费论坛蹲了俩小时没得到精准回复，有偿技术群报价又够我喝一个月奶茶咖啡，气得我差点把刚换的键盘空格键抠烂（还好忍住了，毕竟是我分期三个月的RGB定制款）！

最后抱着“死马当活马医迅睿CMS留言乱码修复我自己来”的心态，啃了三天迅睿的半中文半英文官方文档（英文那部分全靠翻译器反复横跳猜，差点把翻译器累罢工），踩了大大小小七个坑（像什么改了数据库没清缓存、改了模板没保存正确编码、连UTF-8带BOM都碰过），终于找到了一套迅睿CMS留言乱码修复全链路零成本通用方案！今天把这套“血泪教训+独家秘笈”分享给你们，保证看完这篇，你们再也不用为迅睿CMS留言乱码修复掉头发抠键盘！

第一步：先搞明白「迅睿CMS留言鬼画符」到底是啥毛病

家人们在搞任何迅睿CMS留言乱码修复之前，别上来就瞎改代码！不然容易像我第一次那样，把整个小官网的产品页都改成鬼画符（当时差点被老板扣半个月绩效，还好最后救回来了）！先给你们用个魔性接地气的比喻讲清楚原理——咱们的小官网就像个快递驿站，浏览器是快递小哥，MySQL数据库是快递柜，前台表单是快递员写的寄件单：

• 如果寄件单（前台表单）用的是简体中文（GB2312），快递柜（MySQL）用的是繁体中文（BIG5），快递小哥送过去快递柜就认不出来，直接塞进去的就是一堆没人能读的纸条；
• 反之寄件单用的是UTF-8，快递柜用的是GBK，同样会出问题；
• 就算寄件单和快递柜都统一了UTF-8，要是寄件单最后多盖了个没用的小戳戳（UTF-8带BOM编码），快递小哥塞的时候会蹭花纸条，还是读不出来；
• 还有种情况更气人——寄件单没问题、快递柜没问题、塞的时候也没问题，但是取快递的人（你看后台留言或者前台显示留言的人）戴了个有色眼镜（浏览器强制用了其他编码），看到的还是鬼画符！

总之记住一句话：所有的迅睿CMS留言乱码修复，本质上就是把寄件单、快递柜、有色眼镜、中间的传送带（模板输出/数据库连接），全部统一成UTF-8无BOM编码！只要统一了，鬼画符立刻变乖乖的中文+可爱表情！这就是我总结出来的「迅睿CMS留言乱码修复万能定律」，给我刻进DNA里！刻进DNA里！刻进DNA里！（重要的魔性重复三遍，怕你们记不住！）

第二步：跟着过来人踩过的坑，一步步做迅睿CMS留言乱码修复

接下来就是干货环节了！全是我抠烂草稿纸、试坏三台备用电脑（夸张夸张，其实就试坏了一台旧笔记本）总结出来的通用零成本方案，按顺序做，保证一遍过！迅睿CMS留言乱码修复！一遍过！迅睿CMS留言乱码修复！一遍过！（再来两遍魔性重复！）

踩坑1：有色眼镜（浏览器强制编码）先摘掉——这是最简单的迅睿CMS留言乱码修复

别笑！我第一次就是栽在这个最傻的坑里！我那个RGB定制款浏览器（夸张夸张，就是Chrome开了个插件），之前追老港剧设置成了强制BIG5编码，结果自己看自己后台全是鬼画符，还以为是迅睿CMS的锅！所以家人们搞任何迅睿CMS留言乱码修复之前，先把浏览器强制编码改成自动或者UTF-8！

操作步骤（以最常用的Chrome为例，其他浏览器大同小异）：

• 打开你的小官网后台/前台留言页；
• 右键点击页面空白处，选择「查看页面信息」（或者直接按Ctrl+I）；
• 在弹出的窗口里找到「编码」那一栏，改成「Unicode (UTF-8)」；
• 刷新页面试试！

如果改完就没问题了，那恭喜你！你省了三天啃文档的时间！不过别高兴太早，接下来检查一下其他死党用其他浏览器的情况，要是还有问题，继续往下做迅睿CMS留言乱码修复！

踩坑2：传送带（模板输出+数据库连接）先查一遍——这是最容易被忽略的迅睿CMS留言乱码修复

传送带就是连接寄件单和快递柜的中间环节，要是中间环节出了问题，两头再统一也白搭！过来人经验：迅睿CMS默认的传送带是没问题的，但如果你们自己改了模板或者数据库配置文件，那就得小心了！

子步骤2.1：查数据库配置文件的编码

数据库配置文件就是迅睿CMS连接快递柜的“钥匙串”，钥匙串上要是标错了快递柜的开锁密码（编码），就打不开正确的快递格！迅睿CMS的数据库配置文件一般在「config/database.php」里（要是你们安装的时候改了路径，自己找一下带database的.php文件）！

操作步骤（敲黑板！重点操作项都标了strong！）：

• 用记事本别用！别用！别用！记事本打开！因为记事本保存默认是带BOM的UTF-8或者GBK！过来人血泪教训！要用Notepad++或者Sublime Text或者VS Code（这三个都是免费的，随便搜就能下载到）！我用的是VS Code，颜值高还好用，像我的第二台RGB定制款电脑（再次夸张）！
• 下载安装好VS Code之后，打开「config/database.php」文件；
• 在文件里找这两行代码：

```php 'db_charset' => 'utf8mb4', // 数据库编码 'db_collation' => 'utf8mb4_unicode_ci', // 数据库排序规则 ```

• 家人们注意了！要是这两行代码不是「utf8mb4」和「utf8mb4_unicode_ci」，就改成一模一样的！别改其他地方！过来人踩过的坑：之前改成了「utf8」，结果表情还是显示方块儿！因为「utf8」在MySQL里最多只能存3个字节，而咱们常用的emoji表情都是4个字节的！必须用「utf8mb4」！这个非常重要！非常重要！非常重要！（迅睿CMS留言乱码修复+表情修复一箭双雕！）
• 改完之后，在VS Code右下角找到「编码」那一栏（一般显示为「UTF-8」或者「UTF-8 with BOM」），改成「UTF-8」（不带BOM）！然后保存文件！

子步骤2.2：查前台留言模板的编码和输出

前台留言模板就是咱们填寄件单的地方，要是填寄件单的纸有问题，或者寄件单写好之后送的方式有问题，还是会出鬼画符！迅睿CMS的前台留言模板一般在「template/你的模板目录/member/或者module/你的留言模块目录/」里（比如你们用的是默认的留言模块，就找「template/default/module/guestbook/」）！

操作步骤（敲黑板！）：

• 同样用VS Code打开前台留言模板的「index.html」或者「post.html」文件（一般发留言用的是post.html，显示留言用的是index.html，两个最好都查一遍！）；
• 先看文件头部有没有这行代码：

```html ```

• 要是没有，就加到最顶部（在下面一行就行）！要是有但不是「utf-8」，就改成一模一样的！
• 然后在VS Code右下角改成「UTF-8」（不带BOM）！然后保存文件！

踩坑3：寄件单（前台表单）——过来人经验：迅睿CMS默认的没问题，但还是要确认

要是你们自己改了前台留言表单的HTML代码，比如加了一些第三方的输入框插件，那就得确认一下插件的编码是不是UTF-8无BOM！要是没改，这步可以跳过，但为了保险起见，还是用VS Code打开查一下编码就行！

踩坑4：快递柜（MySQL数据库）——这是最核心的迅睿CMS留言乱码修复

前面的都改完了，要是还有问题，那肯定是快递柜本身的编码不对！过来人经验：这步稍微有点技术含量，但别慌！跟着我做，很简单！

子步骤4.1：查数据库和表的编码

操作步骤（以最常用的phpMyAdmin为例，要是你们用的是宝塔面板的phpMyAdmin，更方便！）：

• 打开phpMyAdmin，登录你的MySQL账号密码；
• 选择你的迅睿CMS数据库（一般安装的时候会有前缀，比如dr_xxx）；
• 点击顶部的「操作」选项卡；
• 在「排序规则」那一栏，改成「utf8mb4_unicode_ci」！然后点击「执行」！
• 接下来，找到你的留言模块表（一般是dr_guestbook_data或者dr_你的自定义模块名_data）；
• 同样点击表的「操作」选项卡；
• 在「排序规则」那一栏，改成「utf8mb4_unicode_ci」！然后点击「执行」！
• 找到表里面的留言内容字段（一般是content或者你自定义的字段名）；
• 点击字段旁边的「修改」按钮；
• 在「排序规则」那一栏，改成「utf8mb4_unicode_ci」！然后点击「执行」！

子步骤4.2：（可选）把之前的鬼画符留言恢复过来

要是你们之前已经有了一些鬼画符留言，舍不得删，那可以试试这步！不过过来人经验：这步成功率不是100%，取决于鬼画符乱的程度！乱得轻的话能恢复，乱得重的话就算了！

操作步骤（敲黑板！先备份数据库！先备份数据库！先备份数据库！重要的魔性重复三遍！不然恢复失败哭都没地方哭！）：

• 先在phpMyAdmin里备份你的迅睿CMS数据库！点击顶部的「导出」选项卡，直接默认设置点击「执行」就行！
• 然后点击顶部的「SQL」选项卡；
• 输入以下SQL代码（注意把dr_guestbook_data改成你的留言模块表名，把content改成你的留言内容字段名！）：

```sql UPDATE dr_guestbook_data SET content = CONVERT(CAST(CONVERT(content USING latin1) AS BINARY) USING utf8mb4); ```

• 点击「执行」！
• 刷新后台留言页面试试！要是恢复过来了，恭喜你！要是没恢复过来，别灰心！删掉重新发就行！

踩坑5：最后一步！也是最容易被忘记的一步！清！缓！存！

家人们！过来人血泪教训踩坑最多的一步！就是清！缓！存！迅睿CMS有三个缓存要清：后台缓存、前台缓存、浏览器缓存！一个都不能少！一个都不能少！一个都不能少！（再来三遍魔性重复！）

操作步骤（敲黑板！）：

• 清后台缓存：登录迅睿CMS后台，点击顶部的「系统」选项卡，然后点击左侧的「缓存管理」，最后点击「清除所有缓存」按钮！
• 清前台缓存：登录迅睿CMS后台，点击顶部的「系统」选项卡，然后点击左侧的「网站管理」，最后点击「更新静态缓存」按钮（要是你们没开静态缓存，这步可以跳过！）！
• 清浏览器缓存：按Ctrl+Shift+Delete（Windows）或者Command+Shift+Delete（Mac），选择「缓存的图片和文件」，然后点击「清除数据」按钮！

最后一步！土味正能量强行混搭！家人们加油！

家人们！只要你们按照我这套「血泪教训+独家秘笈」按顺序做迅睿CMS留言乱码修复，保证一遍过！再也不用为迅睿CMS留言乱码修复掉头发抠键盘！再也不用花冤枉钱找技术大佬！再也不用怕老板扣绩效！

最后送大家一句我自己编的土味正能量：「迅睿CMS留言乱码不用怕，过来人带你一键搞定它！只要编码统一UTF-8无BOM，小官网流量咔咔往上涨！」家人们加油！祝你们的小官网越办越好！流量越来越多！订单接到手软！奶茶咖啡喝到腻！RGB定制款键盘随便买！（强行收尾强行正能量强行土味，但都是真心的！）

要是还有家人们做迅睿CMS留言乱码修复没搞定，可以在评论区留言哦！我看到了会尽量回复的！虽然我不是什么专业技术大佬，但我是踩过七个坑的「资深迅睿CMS留言乱码修复过来人」！哈哈哈哈！（松弛感收尾！）