WordPress插件无法在后端获取AJAX回调数据问题

问题核心原因 #

1. AJAX钩子注册错误：多注册了无效的shipping钩子，且缺少登录用户的标准AJAX钩子wp_ajax_shipping。
2. 脚本执行终止逻辑错误：wp_send_json_success()会自动调用wp_die()终止PHP脚本，导致它后面的test_function()根本不会执行。
3. 前端判断逻辑错误：错误判断元素对象而非输入框值，导致空值也会触发请求。
4. 响应格式混乱：直接echo内容会与wp_send_json_success()返回的JSON混合，同时误解了AJAX流程——后端处理逻辑需在发送响应前执行，而非输出到前端。

修复步骤 #

1. 修正后端AJAX钩子与处理逻辑 #

移除无效钩子，确保后端业务逻辑在发送响应前执行，用标准方法返回响应数据：

function shipping1() {
    // 获取前端传参
    $testing = $_GET['billing_first_name_post'];
    
    // 先执行所有后端处理逻辑（比如调用自定义函数）
    test_function(); // 现在会正常执行，因为在响应发送前
    
    // 如果需要给前端返回数据，将内容传入wp_send_json_success
    wp_send_json_success($testing); 
    // 该函数会自动终止脚本，无需额外加wp_die()
}

// 注册正确的AJAX钩子：覆盖登录/未登录用户场景
add_action('wp_ajax_shipping', 'shipping1');
add_action('wp_ajax_nopriv_shipping', 'shipping1');

2. 修复前端判断与AJAX回调 #

修正输入值判断逻辑，同时调整错误回调为jQuery AJAX标准的error方法：

function addEvtListenerToCheckoutPage2()
{
?>
    <script type="text/javascript">
        document.addEventListener("DOMContentLoaded", (event) => {
            document.getElementById('billing_first_name').addEventListener("focusout", function() {
                alert("Hello World!addEvtListenerToCheckoutPage2");
                // 修正判断逻辑：检查输入框值而非元素对象
                if (document.getElementById('billing_first_name').value.trim() !== "") {
                    var billing_first_name = this.value;
                    var my_data = {
                        action: 'shipping',
                        billing_first_name_post: billing_first_name
                    };
                    jQuery.ajax({
                        type: "get",
                        url: "<?php echo admin_url('admin-ajax.php'); ?>",
                        data: my_data,
                        success: function(msg) {
                            console.log("success ajax");
                            console.log(msg.data); // 从返回的JSON中取data字段
                        },
                        // 修正错误回调为error
                        error: function(xhr, status, error) {
                            console.log("error ajax:", error);
                        }
                    });
                }
            });
        });
    </script>
<?php
}
// 替换init钩子为wp_footer，确保脚本在jQuery加载后输出
add_action('wp_footer', 'addEvtListenerToCheckoutPage2');

关键说明 #

• 后端的echo内容会作为AJAX响应返回前端，若无需返回数据给用户，不要使用echo，直接执行处理逻辑即可。
• wp_send_json_success()必须放在所有后端处理逻辑之后，因为它会终止脚本，后续代码不会运行。
• AJAX流程本质是：前端发请求→后端接收参数→执行业务逻辑→返回响应给前端，后端处理逻辑（如写数据库、调用API）是在服务器端静默执行的，控制台看到的是返回的响应内容，属于正常现象。

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