WordPress前端AJAX始终返回0，排查无果求助

我太懂这种WP AJAX返回0的抓狂感了——明明把常规坑（nonce、函数名拼写、钩子注册）都排查了一遍，结果还是卡在这个毫无信息量的返回值上！结合你说的问题出在前端函数，给你梳理几个针对性的排查步骤，都是我踩过无数次坑总结出来的：

一、先确认前端请求的核心参数是否正确 #

WP AJAX的灵魂就是action参数，只要这个错了，一切白搭：

• 大小写敏感！ 比如PHP里注册的是wp_ajax_my_custom_action，前端传my-custom-action或者MyCustomAction都会直接返回0，必须完全匹配
• 检查请求URL：前端要确保用的是正确的admin-ajax.php路径，登录状态下可以直接用全局变量ajaxurl，非登录用户的话，要在PHP里先把路径传给JS：

  wp_localize_script('你的脚本handle', 'ajax_object', array('ajax_url' => admin_url('admin-ajax.php')));
  

  然后前端用ajax_object.ajax_url作为请求地址
• 请求方法验证：虽然WP支持GET/POST，但有些服务器会限制GET请求的AJAX，优先用POST试试，避免不必要的麻烦

二、排查前端函数的参数传递问题 #

如果你的前端函数是封装过的（比如用FormData或者自定义JSON参数），很容易出现参数丢失的情况：

• 直接用最小请求测试：在浏览器控制台写一个极简的AJAX请求，排除其他JS代码的干扰：

  // 用jQuery的情况
  jQuery.post(ajaxurl, { action: '你的action名称' }, function(res) {
      console.log('返回结果:', res);
  }).fail(function(err) {
      console.log('请求错误:', err);
  });
  
  // 用原生fetch的情况
  fetch(ajaxurl, {
      method: 'POST',
      headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
      body: new URLSearchParams({ action: '你的action名称' })
  }).then(res => res.text()).then(console.log);
  

  如果这个极简请求能正常返回预期内容，那说明你原来的前端函数有问题（比如参数被覆盖、FormData没正确添加action、异步逻辑错误）；如果还是返回0，那问题可能还是在PHP端的钩子注册

• 检查nonce的传递（如果用了的话）：即使你说不用nonce也返回0，但如果用了的话要确保_wpnonce参数正确传递——不管是放到FormData里，还是作为URL参数，PHP端用check_ajax_referer()验证时要对应上nonce的action名称，验证失败也会直接返回0

三、容易忽略的PHP端关联问题（别以为前端问题就不用看） #

有时候前端没问题，但PHP端的隐藏错误会导致返回0：

• 必须加终止语句：处理函数的最后一定要加wp_die()或者die()，WP AJAX要求脚本执行完必须终止，否则会自动返回0：

  function my_ajax_handler() {
      // 你的处理逻辑
      echo json_encode(array('status' => 'success'));
      wp_die(); // 这行绝对不能少！
  }
  add_action('wp_ajax_my_custom_action', 'my_ajax_handler');
  add_action('wp_ajax_nopriv_my_custom_action', 'my_ajax_handler'); // 非登录用户也要加这个钩子
  

• 检查钩子注册时机：确保add_action('wp_ajax_*')是在主题的functions.php里直接写的，或者在插件的初始化代码里，不要放到某个只在前端加载的函数里，否则钩子根本没注册上
• 查看服务器错误日志：如果处理函数里有PHP语法错误、未定义变量之类的问题，WP会直接返回0，而且不会在前端显示错误，这时候去服务器的PHP error log里找线索，绝对能发现问题

四、极端排查：排除其他代码干扰 #

如果上面的步骤都没用，那大概率是其他插件或者主题代码干扰了AJAX请求：

• 禁用所有第三方插件，切换到WP默认主题（比如Twenty Twenty-Four），然后用极简的前端+PHP代码测试
• 检查是否有安全插件（比如Wordfence）拦截了AJAX请求，这类插件有时候会误判自定义AJAX请求为恶意请求

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