WordPress AJAX请求中wp_send_json_success响应前端检测失效问题排查

嘿，我一眼就发现问题出在哪了——你PHP函数里的echo 'hello world';这行代码搞砸了JSON响应！

为什么会失败？ #

wp_send_json_success()这个函数本身会帮你做两件关键的事：

1. 输出格式完全合法的JSON响应（就是你看到的{"success":true}）
2. 自动终止脚本执行（相当于自带了die()/exit()，不需要你手动加）

但你在它之前先echo了字符串，导致最终输出的响应内容变成了：

hello world{"success":true}

这种混合了普通文本和JSON的内容，虽然控制台看起来能看到正确的JSON片段，但前端AJAX设置了dataType: 'json'，会因为响应不是合法JSON而解析失败。这时候response要么是null，要么是一个解析错误的对象，自然没法正确判断response.success，所以一直走进失败分支。

怎么修复？ #

很简单，直接删掉两个多余的代码行：

• 删掉echo 'hello world';（测试用的输出会破坏JSON结构）
• 删掉手动的die();（wp_send_json_success()已经自带终止功能）

修改后的PHP函数应该是这样：

function fbpixel_add_to_cart_event_conversion_api() { 
  // 这里保留你的业务逻辑代码，去掉测试echo和多余die
  wp_send_json_success(); 
}
add_action('wp_ajax_fbpixel_add_to_cart_event_conversion_api', __NAMESPACE__.'\\fbpixel_add_to_cart_event_conversion_api');
add_action('wp_ajax_nopriv_fbpixel_add_to_cart_event_conversion_api', __NAMESPACE__.'\\fbpixel_add_to_cart_event_conversion_api');

额外小技巧 #

如果你需要在成功响应里返回额外数据（比如商品ID、状态信息），可以把数据作为参数传给wp_send_json_success()，比如：

wp_send_json_success([
  'product_id' => $_POST['product_id'],
  'message' => '添加购物车成功'
]);

前端就能通过response.data.product_id或者response.data.message拿到这些数据啦。

改完之后再测试，你会发现response.success === true的判断就能正常生效，控制台也会输出预期的成功提示了。

内容的提问来源于stack exchange，提问作者wharfdale