WordPress插件AJAX调用失效，寻求调试与问题排查方案

一、代码核心错误修复 #

先解决你代码里的几个致命问题，这是导致AJAX失效的直接原因：

1. AJAX请求URL写法错误 #

你当前用wp_localize_script(admin_url("admin-ajax.php"))完全不符合语法，wp_localize_script是用来给已注册的JS脚本传递PHP变量的，不能直接输出URL。两种修复方式：

• 快速写法：直接输出admin-ajax地址

  url: '<?php echo admin_url("admin-ajax.php"); ?>',
  

• 规范写法（推荐）：先注册脚本再本地化变量

  // 在PHP部分注册你的JS脚本（假设脚本文件路径为插件目录/js/question.js）
  wp_enqueue_script('question-ajax-script', plugin_dir_url(__FILE__) . 'js/question.js', array('jquery'), '1.0', true);
  // 传递AJAX URL到前端
  wp_localize_script('question-ajax-script', 'QuestionAjax', array(
      'ajax_url' => admin_url('admin-ajax.php')
  ));
  

  前端JS里调用：

  url: QuestionAjax.ajax_url,
  

2. 错误的请求参数配置 #

你用的是普通JS对象formData，不是FormData实例，所以不需要设置processData: false和contentType: false——这两个选项是专门用来处理文件上传的，会导致jQuery无法正确序列化请求数据，后端收不到action参数，直接返回默认值0。直接删掉这两行即可。

3. 后端返回格式不匹配 #

前端dataType设为json，且success回调里判断response.type == "success"，但你当前后端只返回123，会导致前端报错。修改后端处理器返回标准格式：

function create_question_handler() {
    wp_send_json(array(
        'type' => 'success',
        'data' => 123
    ));
    wp_die(); // 确保后续无额外输出，破坏JSON结构
}

二、针对你的问题的调试方法 #

1. 前端控制台无输出 #

• 先在表单提交事件开头加日志，确认事件是否触发：

  $('#question-form').submit(function(e) {
      e.preventDefault();
      console.log('表单提交事件已触发'); // 加这行
      // 后续代码...
  });
  

  如果没输出，检查：表单id是否拼写正确、jQuery是否加载成功（控制台输入jQuery看是否返回函数）、脚本是否放在DOM之后。
• 打开浏览器开发者工具的Network标签，筛选XHR请求，查看：
  • 请求URL是否返回404（URL错误）；
  • 请求参数里是否包含action=create_question（数据序列化错误）；
  • 响应内容是否为0（后端钩子未触发）。

2. 后端输出调试信息 #

• 开启WordPress调试：在wp-config.php中添加：

  define('WP_DEBUG', true);
  define('WP_DEBUG_LOG', true);
  define('WP_DEBUG_DISPLAY', false);
  

  调试日志会写入wp-content/debug.log，不会显示在页面上。
• 在处理器函数中用error_log()记录信息：

  function create_question_handler() {
      error_log('AJAX处理器已触发');
      error_log('收到的POST数据：' . print_r($_POST, true));
      wp_send_json(array('type' => 'success', 'data' => 123));
  }
  

3. 保留AJAX时表单跳转空白页 #

• 确认e.preventDefault()是否生效：在它后面加console.log('已阻止默认提交')，如果没输出，说明事件未绑定成功；
• 检查Network标签的请求状态：如果是500错误，说明后端代码有语法错误，查看debug.log找原因；
• 排查是否有其他JS脚本干扰了表单的submit事件。

4. 确认钩子是否创建、查看处理器输出 #

• 查看钩子注册情况：在插件或主题functions.php中添加代码，打印钩子信息到日志：

  add_action('init', function() {
      global $wp_filter;
      error_log('wp_ajax_create_question钩子注册情况：' . print_r($wp_filter['wp_ajax_create_question'], true));
      error_log('wp_ajax_nopriv_create_question钩子注册情况：' . print_r($wp_filter['wp_ajax_nopriv_create_question'], true));
  });
  

• 查看处理器输出：通过Network标签的响应内容判断，如果钩子触发，会返回你设置的JSON数据；如果未触发，响应为0。

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