AJAX在子主题中正常运行，移至插件类文件时返回错误请求

兄弟，我太懂这种折腾了——明明函数放子主题里好好的，移到类里就炸了，大概率是WordPress的AJAX钩子注册和类的调用方式没搞对，我给你拆解下核心问题和解决办法：

核心原因：类方法的AJAX钩子注册逻辑不一样 #

WordPress的AJAX请求必须通过wp_ajax_{action}和wp_ajax_nopriv_{action}这两个钩子绑定处理函数，但当函数是类的方法时，不能直接传方法名，得用数组形式指定类实例（或类名）+方法名，同时还要注意几个细节：

正确的类文件写法示例 #

class My_Custom_AJAX {
    public function __construct() {
        // 注册AJAX钩子，这里的`my_ajax_action`要和前端AJAX的`action`参数完全一致
        add_action( 'wp_ajax_my_ajax_action', array( $this, 'process_ajax_request' ) );
        // 如果需要允许未登录用户调用，必须加这个钩子
        add_action( 'wp_ajax_nopriv_my_ajax_action', array( $this, 'process_ajax_request' ) );
    }

    // 处理AJAX的方法必须是public！private/protected会导致WordPess无法调用
    public function process_ajax_request() {
        // 重点！Nonce验证是400错误的头号元凶，一定要加
        if ( ! check_ajax_referer( 'my_ajax_nonce_key', 'security' ) ) {
            wp_send_json_error( '非法请求：Nonce验证失败' );
        }

        // 获取前端传递的变量，记得 sanitize 防止注入
        $passed_var = isset( $_POST['my_variable'] ) ? sanitize_text_field( $_POST['my_variable'] ) : '';

        // 这里写你的业务逻辑
        $response_data = "处理完成：你传递的变量是 {$passed_var}";

        // 返回成功响应
        wp_send_json_success( $response_data );
    }
}

// 初始化类，确保这段代码在WordPress加载流程中执行（比如在子主题functions.php里引入类文件后初始化）
new My_Custom_AJAX();

对应的前端AJAX代码要匹配 #

jQuery(document).ready(function($) {
    var myVar = '我是要传递的内容';

    $.ajax({
        // 后台直接用ajaxurl，前台需要通过wp_localize_script传递（下面会说）
        url: typeof ajaxurl !== 'undefined' ? ajaxurl : my_ajax_obj.ajax_url,
        type: 'POST',
        data: {
            action: 'my_ajax_action', // 必须和PHP钩子里的`my_ajax_action`完全一致
            security: my_ajax_obj.nonce, // Nonce要和PHP生成的对应
            my_variable: myVar
        },
        success: function(res) {
            if (res.success) {
                console.log('请求成功：', res.data);
            } else {
                console.error('请求失败：', res.data);
            }
        },
        error: function(xhr, status, err) {
            console.log('AJAX错误详情：', status, err);
        }
    });
});

必须注意的几个坑（踩过的都懂） #

• Nonce验证没做/做错：这是400错误最常见的原因！WordPress会直接拦截没有正确Nonce的请求，必须用wp_create_nonce生成Nonce，再通过wp_localize_script传到前端：

// 在子主题functions.php里添加，用于传递AJAX必要的变量到前端
add_action('wp_enqueue_scripts', function() {
    // 先加载你的AJAX脚本
    wp_enqueue_script('my-ajax-script', get_stylesheet_directory_uri() . '/js/ajax.js', ['jquery'], '1.0', true);
    
    // 本地化脚本，传递ajax地址和nonce
    wp_localize_script('my-ajax-script', 'my_ajax_obj', [
        'ajax_url' => admin_url('admin-ajax.php'),
        'nonce' => wp_create_nonce('my_ajax_nonce_key')
    ]);
});

• 类方法权限不对：处理AJAX的方法必须是public，如果设成private或protected，WordPress无法调用，直接返回错误。
• 钩子注册时机不对：如果你的类初始化代码在WordPress的init钩子之前执行，钩子可能没注册成功。可以把类的初始化放到init钩子里：

add_action('init', function() {
    require_once get_stylesheet_directory() . '/classes/class-my-custom-ajax.php';
    new My_Custom_AJAX();
});

• action参数不匹配：前端AJAX的action参数必须和PHP钩子里的wp_ajax_{action}的action部分完全一致，多一个字母少一个字母都会导致找不到处理函数。
• 类文件没加载：如果你的类文件路径写错，或者没有被include到WordPress的加载流程里，钩子根本没注册，自然请求失败。

排查步骤 #

如果还是不行，打开浏览器控制台的「Network」面板，查看AJAX请求的响应内容——400错误通常会返回具体原因（比如Nonce无效），照着改就行。

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