WordPress网站多类故障求助：无效JSON响应及WP_Theme_JSON_Resolver异常

故障现象 #

• 上传图片时提示「响应不是有效的JSON格式」
• 无法更新现有页面、安装新插件或主题
• SSL插件返回500状态码
• 开启WP调试后，后台出现以下错误提示：
  • wp_enqueue_style调用错误
  • is_feed调用错误
  • WP_Theme_JSON_Resolver::get_user_data()解析theme.json语法错误

排查与修复步骤 #

1. 优先修复theme.json语法错误 #

调试提示的theme.json解析错误是核心诱因之一：

• 找到Astra主题目录下的theme.json文件（通常在主题根目录或assets子目录）
• 使用JSON校验工具检查文件语法，重点排查：
  • 遗漏的逗号、不闭合的引号
  • 括号/括号不匹配
  • 非法的JSON值（比如未加引号的字符串）
• 修复所有语法错误后保存，刷新后台验证效果

2. 排查自定义代码冲突 #

当前functions.php末尾添加了自定义JS代码，可能导致输出异常：

• 备份functions.php文件后，临时移除以下代码：

function add_custom_js_inline() {
    ?>
    <script>
    document.addEventListener('DOMContentLoaded', () => {
        const observerOptions = {
            root: null,
            rootMargin: '0px',
            threshold: 0.1
        };

        const observer = new IntersectionObserver((entries, observer) => {
            entries.forEach(entry => {
                if (entry.isIntersecting) {
                    entry.target.classList.add('visible');
                    observer.unobserve(entry.target);
                }
            });
        }, observerOptions);

        document.querySelectorAll('.edplus_anim-L5I9H8second, .edplus_anim-L5I9H8third').forEach(element => {
            observer.observe(element);
        });
    });
    </script>
    <?php
}
add_action('wp_footer', 'add_custom_js_inline');

• 测试后台上传、更新等操作，若恢复正常，说明自定义代码存在输出干扰（比如PHP标签前后的多余空格），重新编写时需严格控制输出内容

3. 解决500错误与后台操作故障 #

• 重置主题设置：通过Astra主题面板的「重置设置」功能，或直接删除数据库中wp_options表的astra-settings选项，重置主题配置
• 禁用所有插件：通过FTP将wp-content/plugins文件夹重命名为plugins-disabled，测试后台功能是否恢复。若正常，逐个恢复插件找出冲突项
• 检查PHP版本：确保服务器PHP版本≥7.4（Astra 4.7.3的最低要求），过低版本会导致函数调用错误
• 修复wp_enqueue_style错误：检查主题inc/core/class-astra-enqueue-scripts.php文件，确保所有wp_enqueue_style调用的参数合法（handle名称唯一、资源路径正确）
• 修复is_feed调用错误：排查主题代码中是否在WordPress初始化完成前调用is_feed()，将相关代码移至after_setup_theme或wp等合适的钩子中执行

4. 上传图片JSON错误额外修复 #

• 临时调整调试配置：若WP_DEBUG开启，可能输出错误信息干扰JSON响应，在wp-config.php中添加：

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

• 检查服务器权限：确保wp-content/uploads文件夹权限为755，所有权与服务器运行用户一致
• 联系主机商：确认mod_security规则是否拦截了上传请求，请求调整或关闭相关规则

内容的提问来源于stack exchange，提问作者Harris.K. L