WordPress上传图片错误：不是合法的JSON响应解决办法
在使用WordPress更新文章或上传媒体文件时，许多用户可能会遇到一个令人头疼的提示：“上传失败。不是合法的JSON响应”。这个问题在WordPress升级到5.0版本并默认采用古腾堡编辑器后尤为频发。由于古腾堡编辑器强依赖REST API进行数据交互，当服务器或网站设置阻止或破坏了这些请求时，就会导致前端无法解析预期的JSON格式数据。本文将详细分析该错误的常见原因，并提供多种行之有效的解决办法。
一、刷新固定链接与伪静态规则
这是最常见且最简单的修复方式。当服务器的伪静态规则与WordPress不匹配，或者在迁移网站后规则丢失时，REST API的请求会被重定向或返回404页面，从而导致JSON解析失败。
操作步骤：
登录WordPress后台。
进入“设置” -> “固定链接”。
不做任何修改，直接点击底部的“保存更改”按钮。
此操作会强制WordPress重新生成并写入 .htaccess 文件（Apache服务器）或更新对应的伪静态规则。如果服务器环境使用的是Nginx，请确保Nginx配置文件中包含了标准的WordPress伪静态规则。以下是一个常见的Nginx伪静态配置示例：
location / {
try_files $uri $uri/ /index.php?$args;
}排查并禁用冲突插件
某些安全插件、缓存插件或SEO优化插件会拦截或修改REST API的响应头，导致前端无法正确读取JSON数据。特别是具有“隐藏WordPress特征”或“防火墙”功能的安全插件，极易误判正常的上传请求为恶意攻击。
操作步骤：
通过FTP或主机控制面板，进入网站根目录的
wp-content/plugins文件夹。将当前使用的插件文件夹重命名（例如在名称前加上下划线
_），使其暂时失效。逐个恢复插件并测试上传功能，直到定位到引发冲突的具体插件。
常见的冲突插件包括Wordfence、Sucuri Security等。如果定位到冲突插件，可以寻找替代插件或在插件设置中为REST API添加白名单。
切换为经典编辑器
古腾堡编辑器依赖REST API，而经典编辑器使用传统的 admin-ajax.php 进行通信。如果服务器环境由于某些安全策略限制无法开放REST API，安装经典编辑器可以作为有效的临时替代方案。
操作步骤：
在后台“插件” -> “安装插件”中搜索“Classic Editor”。
安装并启用该插件。
在“设置” -> “撰写”中，将默认编辑器设置为经典编辑器。
检查服务器安全规则与WAF防火墙
除了WordPress内部的安全插件，服务器层面的Web应用防火墙（WAF）或ModSecurity规则也可能拦截包含特定字符的上传请求。某些服务器安全规则会严格检测上传内容，如果图片元数据中包含类似 <script> 或 <input> 的HTML标签字符串，可能会被防火墙直接阻断，返回HTML格式的拦截页面，进而触发非法JSON响应错误。
操作步骤：
登录服务器管理面板（如宝塔面板、cPanel等）。
找到Web应用防火墙或ModSecurity设置，暂时将其关闭。
再次尝试在WordPress中上传图片。
如果关闭防火墙后恢复正常，说明是安全规则误杀。需要在防火墙中为WordPress的上传接口添加白名单规则。例如，针对 https://www.ipipp.com/wp-json/wp/v2/media 路径放行。
修改PHP配置限制
当上传的图片体积过大，超出了PHP配置允许的最大上传尺寸或POST数据尺寸时，服务器可能会截断请求，导致返回的数据不完整或报错页面。
需要检查并修改 php.ini 文件中的以下参数：
upload_max_filesize = 64M post_max_size = 64M max_execution_time = 300 max_input_time = 300 memory_limit = 128M
修改后需重启Web服务使配置生效。同时，如果在网站根目录的 .htaccess 文件中添加了过小的限制，也需要同步调整。例如我们在编写前端表单时，若使用了类似 <input type="hidden"> 的标签传递参数，也需要确保表单的 enctype 属性支持大文件传输。
修复文件和目录权限
如果WordPress的上传目录没有写入权限，图片无法保存到服务器，也会触发该错误。
操作步骤：
通过SSH或FTP连接服务器。
检查
wp-content/uploads目录及其子目录的权限。将目录权限设置为
755，将文件权限设置为644。确保目录的所有者与Web服务器运行用户（如
www或nginx）一致。
遇到“不是合法的JSON响应”错误时，建议按照上述顺序逐一排查。多数情况下，刷新固定链接或排查插件冲突即可解决问题。如果仍然无法解决，可以通过浏览器的开发者工具（F12）查看网络请求的具体返回内容，这将为定位问题提供更精确的线索。