WordPress add_action/do_action钩子与AJAX请求不生效问题排查

你的AJAX请求配置完全不符合WordPress的AJAX运行逻辑：

1. wp_ajax_{action}、wp_ajax_nopriv_{action}这两个钩子是WordPress核心在wp-admin/admin-ajax.php入口中触发的，只有请求发送到这个官方入口时，对应的钩子才会执行。你现在把ajaxurl指向了主题目录下自定义的email.php，访问这个文件时不会加载WordPress核心，add_action、wp_die这类WordPress函数根本无法调用，钩子自然不会生效。
2. 你把钩子注册代码写在独立的email.php里也是错误的：WordPress只会自动加载主题根目录的functions.php文件，你单独创建的PHP文件如果没有被WordPress流程引入，里面写的所有代码都不会在WordPress生命周期内执行。

这也能解释你遇到的现象：当你删掉所有WordPress相关函数，只在email.php里写原生PHP的echo 'Success'时，文件被直接访问当然能返回内容，这时候根本没走任何WordPress逻辑。

按以下步骤调整即可：

• 把email.php里的钩子注册和回调函数代码全部移动到主题的functions.php文件中，email.php文件可以直接删除，后续不需要这个自定义文件。
  移入functions.php的代码如下：

  add_action( 'wp_ajax_nopriv_contact', 'contact' );
  add_action( 'wp_ajax_contact', 'contact' );
  function contact() {
    echo 'Success';
    wp_die();
  }
  

• 修正脚本加载时的AJAX地址配置，不要指向自定义文件，使用WordPress自带函数获取官方AJAX入口地址，修改后的load_script函数如下：

  function load_script()
  {
    wp_enqueue_script( 'contact_form', get_template_directory_uri() . '/contact_form/contact_form.js', array('jquery') );
    wp_localize_script( 'contact_form', 'ajax_object', array(
      'ajaxurl' => admin_url( 'admin-ajax.php' )
    ));
  }
  add_action('wp_enqueue_scripts', 'load_script');
  

• 前端contact_form.js的代码不需要改动，保持原有传action: 'contact'参数的写法即可，调整完成后测试就能正常拿到返回结果。

• 你尝试在email.php里写自定义钩子加do_action的写法无效，是因为访问该文件时WordPress核心未加载，add_action函数本身不存在，PHP会直接抛出致命错误，不会有正常返回。
• 你给add_action加优先级参数无效，是因为问题和钩子优先级无关，核心是你的钩子注册代码从来没有被WordPress执行过。

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