wordpress后台添加或更新页面时出现“响应不是有效的json响应”错误，通常是因为短代码函数直接输出html而非返回字符串，破坏了rest api的json响应结构。
wordpress后台添加或更新页面时出现“响应不是有效的json响应”错误，通常是因为短代码函数直接输出html而非返回字符串，破坏了rest api的json响应结构。
在WordPress中，短代码（shortcode）回调函数必须返回字符串，而非直接输出（echo/print）HTML内容。当您在testfunc()中使用PHP混排HTML（如<div class="testcl">test</div>），PHP会立即将该HTML发送至输出缓冲区——而WordPress编辑器（尤其是基于Block Editor/Gutenberg的REST接口）依赖干净的JSON响应来保存页面。任何意外的HTML、空白字符、PHP警告或Notice都会污染HTTP响应体，导致前端解析JSON失败，从而抛出“The response is not a valid JSON response”这一经典错误。
✅ 正确做法：使用输出控制函数（Output Buffering）捕获HTML并显式返回：
<?php
/*
* Plugin Name: Test Shortcode
* Description: A minimal shortcode plugin demonstrating safe HTML output.
*/
function testfunc() {
ob_start(); // 启动输出缓冲
?>
<div class="testcl">test</div>
<?php
return ob_get_clean(); // 获取并清空缓冲区内容，作为字符串返回
}
add_shortcode('test', 'testfunc');
?>⚠️ 关键注意事项：
-
绝不使用
echo、print或裸HTML混排 在短代码函数中（除非已用ob_start()包裹）； - 确保函数有且仅有一个
return语句，返回纯字符串（可含HTML标签，但不可含额外换行、空格或PHP错误信息）； - 开发阶段建议启用
WP_DEBUG，避免Notice/Warning被输出到响应中； - 若需动态数据（如
get_post_meta），务必做null/false检查，防止null被转为字符串"null"引发意外交互； - 避免在短代码中执行耗时操作（如远程请求、大查询），以免拖慢编辑器保存流程。
总结：短代码的本质是“内容生成器”，其职责是计算并返回HTML字符串，而非“渲染”。牢记 ob_start() + ob_get_clean() 这一黄金组合，即可彻底规避JSON响应污染问题，确保插件与WordPress现代编辑器完全兼容。
立即学习“前端免费学习笔记（深入）”；
