宝塔面板 消息推送 宝塔面板消息推送列表中心词标题显示有误

显示有误？这个坑我帮你踩过了

"老王，快来看！咱们宝塔面板的消息推送列表标题怎么显示成乱码了？" 正在喝咖啡的我差点被同事这句话呛到，作为团队里最常折腾服务器的人，这种"惊喜"我已经见怪不怪了。

问题现象还原

那天早上,我像往常一样登录宝塔面板，准备查看夜间自动任务的执行情况，点开"消息推送"模块时，发现列表中的部分消息标题显示异常——有的显示为空白，有的变成了"undefined"，更有甚者直接显示了一串看不懂的代码片段。

"这不科学啊，"我嘀咕着，"昨天还好好的，怎么过了一夜就出问题了？"更奇怪的是，点击进入详情页后，消息内容本身是完整正常的，只有列表页的标题显示有问题。

问题排查过程

第一步：检查最近操作

我仔细回忆了最近对服务器做的改动：

• 前天晚上更新了宝塔面板到最新版（7.9.8）
• 昨天中午安装了一个第三方消息推送插件
• 昨晚修改过nginx的某些配置

第二步：基础检查

1. 清除浏览器缓存：老套路了，Ctrl+F5强制刷新，问题依旧
2. 换浏览器测试：从Chrome换到Edge，同样的问题
3. 手机端访问：通过手机浏览器查看，标题显示依然异常

第三步：深入分析

打开开发者工具（F12），我注意到几个异常现象：

• 网络请求中获取消息列表的API返回数据正常
• 但渲染到页面时,标题字段被错误处理了
• 控制台没有报错信息

问题原因

经过一番折腾,终于找到了罪魁祸首：面板最近一次更新引入的JavaScript处理逻辑变更。

1. 消息推送列表的渲染逻辑修改后,对标题字段做了额外的HTML实体解码
2. 但某些特殊字符（特别是包含单引号或HTML标签的消息标题）会导致解析失败
3. 失败后没有正确的回退机制,直接显示原始数据或undefined

解决方案

临时解决方法

1. 手动修改消息标题：对于已经存在的异常消息，可以编辑消息内容，避免使用特殊符号
2. 使用API直接查询：通过宝塔API接口获取消息列表，绕过前端渲染问题

彻底解决方案

1. 等待官方修复：这个问题已经在2025年8月的版本更新中被确认并修复
2. 升级到最新版：如果你看到这篇文章时已经发布了修复版本，直接升级是最佳选择
3. 自定义修复（适合技术用户）：
   • 定位到/www/server/panel/BTPanel/static/js/msg_push.js
   • 渲染相关代码（约在120行附近）
   • 修改处理逻辑,增加对异常情况的判断

预防措施

1. 规范化：避免在标题中使用HTML标签或特殊符号
2. 定期备份面板配置：出现问题时可快速回滚
3. 关注更新日志：特别是涉及前端渲染的改动要格外注意

写在最后

那天折腾到午饭时间才搞定这个问题,让我深刻体会到——再成熟的面板也难免会有小bug，关键是要保持冷静，一步步排查，如果你也遇到了类似问题，希望这篇文章能帮你少走弯路，当电脑前的东西开始变得奇怪时，先深呼吸，然后检查最近的改动，十有八九能找到原因。

（本文基于2025年8月版本宝塔面板的实际使用经验整理，具体表现可能因版本不同而有所差异）