WordPress 4.8升级后TinyMCE编辑器加载pt.js插件报错如何排查

你遇到的是WordPress 4.8版本升级后，主题兼容问题导致的TinyMCE编辑器加载异常，具体报错为：

Failed to load plugin url: https://www.example.com/wp-includes/js/tinymce/langs/pt.js

• 主题自定义编辑器配置兼容失效：WordPress 4.8同步升级了TinyMCE内核版本，很多旧主题会通过tiny_mce_before_init钩子修改编辑器的语言包路径、加载自定义扩展、调整初始化参数，旧的自定义配置在新版本内核下逻辑出错，就会指向不存在的语言包路径，触发你遇到的pt.js加载失败问题。
• 主题后台资源冲突：部分主题会在后台编辑器页面强制注入自定义JS/CSS资源，和升级后的TinyMCE内核资源产生冲突，打断初始化流程，导致依赖文件加载失败。
• 主题错误覆写全局语言配置：部分支持多语言的主题会错误修改后台全局语言参数，导致TinyMCE尝试加载站点未配置的语言包文件。

1. 开启WordPress调试模式
   在站点根目录的wp-config.php文件中修改以下配置：

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

复现编辑器报错后，查看wp-content/debug.log文件，直接定位到主题代码中触发报错的具体函数。
2. 排查主题中的TinyMCE钩子
全局搜索当前主题的functions.php文件以及同目录下的自定义功能文件夹，查找tiny_mce_before_init、mce_buttons、mce_external_plugins这几个编辑器专属钩子，检查是否有修改语言配置、加载自定义资源的逻辑。
3. 校验TinyMCE初始化参数
打开编辑器页面后，按F12调出浏览器开发者工具，在控制台执行以下代码：

console.log(tinyMCEPreInit)

查看输出内容中的language参数，如果参数值为pt但你的站点并未配置葡萄牙语，就可以确认是主题错误覆写了编辑器语言参数。
4. 对比网络请求差异
在开发者工具的「网络」面板中，分别在启用默认主题和问题主题的状态下刷新编辑器页面，对比TinyMCE相关的请求地址、参数差异，直接定位被主题修改的配置项。

内容的提问来源于stack exchange，提问作者Mburlo