WordPress 官方不提供升级前的实时插件兼容性列表,最可靠的方法是在 staging 环境测试升级,并检查插件详情页的“兼容至”版本。直接在生产环境升级前,务必备份全站数据并确认 PHP 版本满足新要求。
先说结论:没有官方兼容性清单,依赖开发者自测数据和本地环境验证。
- 适合:所有计划执行核心升级的 WordPress 站点
- 先看:插件详情页的"Tested up to"版本号和站点健康状态
- 建议:先在克隆环境升级验证,再操作生产站点
快速处理思路
由于不存在直接查询兼容性列表的命令,建议通过 WP-CLI 检查当前状态并结合后台页面人工核对。使用 wp core update-check 确认是否有新版本,使用 wp plugin list 查看当前插件版本。重点登录 WordPress 后台"更新"页面,查看系统标记的兼容性提示,部分插件会显示与新核心版本的兼容性警告。
为什么会这样
WordPress 核心与插件之间没有强制的兼容性认证机制。插件详情页的"兼容至"版本由开发者自行在 readme.txt 中申报,未经过官方自动化测试验证。核心升级可能引入废弃函数或行为变更,导致旧插件报错,因此官方文档建议通过测试环境验证而非依赖列表。
分步处理
第一步:全站备份
使用主机面板或插件备份数据库和 wp-content 目录。确保拥有可立即还原的快照,这是升级失败后的唯一回滚保障。
第二步:检查站点健康
进入后台"工具">"站点健康",查看"状态"标签页。解决所有标记为"严重"的问题,特别是 PHP 版本和数据库版本警告,确保环境满足新核心要求。
第三步:核对插件信息
进入"插件">"已安装插件",逐个查看关键插件详情页。确认"兼容至"版本号大于或等于目标核心版本。若显示"未测试",需联系开发者或准备替代方案。
第四步: staging 环境验证
在本地或 staging 环境克隆站点,执行核心升级。观察前台页面加载、后台功能操作及错误日志。确认无致命错误后再在生产环境操作。
第五步:执行升级
在生产环境开启维护模式,执行核心升级。升级完成后立即关闭维护模式并检查前台。
怎么验证是否生效
升级后访问站点首页和关键功能页面,确认无白屏或布局错乱。进入后台"工具">"站点健康",确认无新增兼容性警告。检查服务器错误日志(如 error_log),确认无 PHP Fatal Error 或 Deprecated 警告激增。若使用 WP-CLI,运行 wp core version 确认版本号已更新。
常见坑
"兼容至"不等于保证可用:开发者可能未及时更新 readme 数据,显示兼容不代表实际测试过。
自动更新风险:开启核心自动更新前,必须确保所有关键插件已验证兼容,否则可能导致站点无人值守时宕机。
PHP 版本滞后:新核心版本往往要求更高 PHP 版本,升级核心前未升级 PHP 会导致站点无法访问。
常见问题
升级后站点白屏了怎么办?
立即通过 FTP 或主机文件管理器重命名 wp-content/plugins 文件夹禁用所有插件,若恢复则逐个启用排查故障插件。若仍无法恢复,使用备份还原数据库和文件。
插件显示"未测试"能升级核心吗?
不建议直接升级。先在测试环境尝试,若测试环境报错则联系插件开发者或寻找替代插件,生产环境直接升级风险极高。
如何关闭核心自动更新?
在 wp-config.php 中添加 define( 'WP_AUTO_UPDATE_CORE', false ); 可关闭核心自动更新,便于手动控制升级时机和兼容性验证。
参考来源
- WordPress.org - 更新 WordPress:https://wordpress.org/support/article/updating-wordpress/
- WordPress.org - 站点健康屏幕:https://wordpress.org/support/article/site-health-screen/
- Developer WordPress - readme.txt 标准:https://developer.wordpress.org/plugins/wordpress-org/how-to-use-subversion/#readme-txt