
在 WordPress AJAX 回调函数中,若需直接输出合法 JSON 响应,应使用 wp_send_json()(推荐)或手动设置头信息 + echo + die(),而非 json_decode()(该函数用于解析 JSON 字符串为 PHP 变量,不能用于输出)。
在 wordpress ajax 回调函数中,若需直接输出合法 json 响应,应使用 `wp_send_json()`(推荐)或手动设置头信息 + `echo` + `die()`,而非 `json_decode()`(该函数用于解析 json 字符串为 php 变量,不能用于输出)。
在 WordPress 中处理 AJAX 请求并返回 JSON 数据时,关键在于响应的完整性、合法性与安全性。你提供的代码存在多个核心问题:
- 误用 json_decode():该函数作用是将 JSON 字符串转换为 PHP 数组或对象,不是用于输出 JSON;直接 echo json_decode(...) 会输出 NULL(因解析失败)或不可读内容,且无法保证格式正确。
- JSON 字符串本身语法错误:示例中 "testState" 内部缺少逗号分隔("1": [...] "2": [...] 应为 "1": [...], "2": [...]),且末尾多出一个 ],导致 json_decode() 解析失败,进而 echo 无输出。
- 未设置响应头:纯 echo 不会自动发送 Content-Type: application/json,前端可能无法正确解析。
- 缺少 die() 或 wp_die() 的安全终止:WordPress AJAX 处理要求显式终止脚本,否则会追加主题 HTML 内容,破坏 JSON 结构。
✅ 正确做法(推荐):使用 WordPress 内置的 wp_send_json()
该函数自动设置 Content-Type: application/json、输出格式化 JSON,并调用 die() 安全退出:
add_action('wp_ajax_nopriv_inboundCall', 'testFunction');
add_action('wp_ajax_inboundCall', 'testFunction');
function testFunction() {
// ✅ 修复 JSON 语法(注意逗号、括号匹配)
$json_string = '{
"testData": [
{"_id": "1", "name": "testName1"},
{"_id": "2", "name": "testName2"}
],
"testState": {
"1": [1, 0],
"2": [1, 0]
}
}';
// ✅ 解析为 PHP 数组后由 wp_send_json 自动编码(更安全、可扩展)
$data = json_decode($json_string, true);
if (json_last_error() !== JSON_ERROR_NONE) {
wp_send_json_error(['message' => 'Invalid JSON format']);
}
wp_send_json($data); // 自动 header + json_encode + die
}
⚠️ 若坚持直接输出原始 JSON 字符串(不推荐,易出错):
function testFunction() {
$raw_json = '{...}'; // 确保此处 JSON 100% 有效(建议用 jsonlint 验证)
status_header(200);
header('Content-Type: application/json; charset=utf-8');
echo $raw_json;
die();
}
? 重要注意事项:
- 永远不要在 AJAX 回调中 return JSON 数据——WordPress 不捕获返回值,必须 echo + die 或使用 wp_send_json* 系列函数;
- 开发阶段启用 WP_DEBUG,配合 error_log(json_last_error_msg()) 快速定位 JSON 解析错误;
- 生产环境避免硬编码 JSON 字符串,建议从数据库、配置文件或 wp_localize_script 动态生成;
- 使用 wp_send_json_success() / wp_send_json_error() 可统一响应结构,便于前端统一处理。
遵循以上规范,即可稳定、安全地在 WordPress 中返回标准 JSON 响应。











