17370845950

本文详解 wordpress 升级至 5.9 后因文件不完整引发 `call_user_func_array()` 回调错误及 `wp_json_file_decode()` 未定义致命错误的成因与系统性修复方案。

该错误并非配置或环境问题，而是典型的WordPress 核心文件升级中断或覆盖不全所致。关键线索在于两处报错：

• function '_add_default_theme_supports' not found：说明 wp-includes/theme.php 中本应存在的内部函数缺失；
• Call to undefined function wp_json_file_decode()（位于 blocks.php 第 238 行）：该函数自 WordPress 5.9 正式引入（见 core.trac.wordpress.org），若此函数不存在，意味着 wp-includes/functions.php 仍为旧版本（如 5.8 或更早），而其他文件（如 blocks.php）却已更新为 5.9 版本——造成严重版本错配。

此类问题在本地开发环境（如 Laragon）、手动覆盖升级、FTP 传输中断或插件/脚本误删文件时高频发生。

✅ 推荐修复流程（安全、彻底、可复现）：

1. 停止所有自动更新与插件操作
   确保 wp-config.php 中禁用自动更新：

   define('WP_AUTO_UPDATE_CORE', false);

2. 执行干净重装（首选方案）

   • 从 wordpress.org/download 下载官方完整版 ZIP 包（对应你当前目标版本，如 wordpress-6.5.5.zip）；
   • 解压后，仅保留并上传以下目录/文件（覆盖原站点，不要删除数据库）：

     wp-admin/
     wp-includes/
     wp-load.php
     wp-blog-header.php
     index.php
     wp-config-sample.php （可选）

   • ⚠️ 注意：切勿覆盖 wp-content/ 目录（含主题、插件、上传文件）和 wp-config.php（含数据库配置）；

3. 验证核心完整性
   登录 WordPress 后台 → “仪表盘” → 查看右上角版本号，并进入 “更新” → “重新安装更新”（WordPress 5.5+ 提供此按钮），强制校验并修复所有核心文件。

4. 替代方案：使用 WP-CLI（适用于高级用户）
   若服务器支持命令行，SSH 进入网站根目录后执行：

   wp core download --version=6.5.5 --force
   wp core verify-checksums

   输出 Success: All checksums match. 即表示核心文件完整。

? 附加排查建议：

• 检查 wp-includes/functions.php 是否包含 wp_json_file_decode() 函数（搜索关键词即可）；
• 确认 PHP 版本 ≥ 7.4（WordPress 5.9 最低要求），Laragon 默认 PHP 8.0+ 通常满足；
• 避免使用“半手动升级”（如只替换部分文件夹），务必采用全量覆盖或官方升级机制。

? 总结： 此类错误本质是“混搭版本”——新模块调用旧内核未提供的函数。唯一可靠解法是统一、完整、原子化地恢复 WordPress 核心文件。迁移插件（如 All-in-One WP Migration）虽可用于整站备份还原，但其本质仍是重建环境，无法绕过核心文件校验环节。预防胜于修复：今后升级务必通过后台“更新”界面操作，或使用 wp core update 命令，确保事务完整性。