前几天网站出现一个问题,已经修复了,在这里记录一下排查过程和原因,也给大家提供一个排查思路。
一、问题现象
在前台点「编辑文章」,页面能正常打开,标题也显示正常,但是正文编辑框完全空白,看不到任何内容,自然也没法编辑保存。而后台编辑一直正常。
二、排查过程
1. 先对比了本站和另一个同主题测试站的所有 JS 文件,MD5 完全一致,排除了文件损坏;
2. 用无痕窗口、干净浏览器测试,问题依旧,排除了浏览器插件捣乱;
3. 禁用了之前临时加的兼容补丁再测试,问题依旧,排除了补丁影响;
4. 最后按 F12 打开浏览器控制台,发现了关键报错:e.uniqueSort is not a function,顺藤摸瓜找到了原因。
三、真正原因
网站升级到新版 WordPress 后,系统自带的 jQuery UI 组件升级到了 1.14 版本,它要求 jQuery 版本不低于 1.12。而子比主题前台用的是自带的 jQuery 1.9.1,版本较老,缺少 jQuery UI 1.14 需要的 uniqueSort 函数。
jQuery UI 初始化时一调用这个不存在的函数就报错,编辑器跟着初始化失败,正文内容填不进编辑框,表现出来就是「编辑框空白」。测试站没出问题,是因为它的 WordPress 版本旧一些,自带的 jQuery UI 是 1.13,对老 jQuery 还兼容。
四、修复方法
在服务器上添加了一个很小的兼容代码(几行 JS,做成 mu-plugin),作用是把 jQuery 1.9 已有的 unique 函数桥接成 uniqueSort,让新版 jQuery UI 能正常运行。这段代码只作用于前台页面,后台不受任何影响。添加后清了缓存,编辑框立刻恢复正常,文章内容完整显示,编辑保存都没问题。
五、小结
① 以后网站升级 WordPress 之后,建议顺手测一下前台发帖、编辑这些带编辑器的功能;
② 遇到页面某个功能突然失效,先按 F12 打开控制台看有没有红色报错,报错信息对定位问题非常有帮助,别急着怀疑浏览器、网络或者缓存。
目前前台编辑文章已完全正常,有问题欢迎在本板块反馈。





没有回复内容