如何在加载Ajax功能类前检查页面模板？

在WordPress主题的functions.php中编写了加载Ajax功能类的代码：

$ajaxClass = '\Theme\Ajax\' . $name;
new $ajaxClass;

遇到以下问题：

• 使用get_page_template()验证模板名称时，功能无法生效；
• 通过钩子加载整个功能时，要么关联JS未加载，要么Ajax调用返回“Bad Request”错误；
• 不添加模板名称检查时，所有功能正常运行。

• 修正模板检查的时机与方式：
  get_page_template()需要在全局$post对象初始化后调用，建议在template_redirect或wp钩子中执行模板判断，避免在init等过早的钩子中调用。同时推荐使用is_page_template('模板文件名.php')直接判断，而非直接比较get_page_template()返回的完整文件路径，避免路径字符串不一致导致判断失效。

• 排查Ajax钩子与权限验证：
  “Bad Request”通常源于nonce验证失败、动作名称不匹配或权限问题：

  1. 确保Ajax动作注册（add_action('wp_ajax_xxx', ...)和wp_ajax_nopriv_xxx）在类实例化后正确执行，钩子时机建议在init；
  2. 前端JS中必须正确传递nonce参数，且与后端check_ajax_referer('nonce名称')的验证名称完全一致；
  3. 确认动作名称（wp_ajax_后的部分）与JS请求中action参数的值完全匹配。

• 规范JS加载逻辑：
  JS文件需在wp_enqueue_scripts钩子中加载，结合模板判断确保仅在目标模板页面加载：

  add_action('wp_enqueue_scripts', function() {
      if (is_page_template('your-target-template.php')) {
          wp_enqueue_script('theme-ajax', get_template_directory_uri() . '/js/ajax-handler.js', ['jquery'], '1.0', true);
          wp_localize_script('theme-ajax', 'ThemeAjax', [
              'ajax_url' => admin_url('admin-ajax.php'),
              'nonce' => wp_create_nonce('theme_ajax_nonce')
          ]);
      }
  });
  

• 确认命名空间类的加载：
  确保\Theme\Ajax\命名空间下的类已通过自动加载机制（如Composer autoload或自定义spl_autoload_register）正确加载，避免实例化时出现类未找到的错误。

• 开启调试定位问题：
  开启WP_DEBUG和WP_DEBUG_LOG，查看wp-content/debug.log中的错误信息，同时通过浏览器开发者工具查看Ajax请求的参数、响应内容，定位具体的执行错误点。

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