WordPress AJAX表单提交出现400 Bad Request错误求助排查

核心错误原因 #

1. 未传递AJAX action参数 #

WordPress的admin-ajax.php依赖action参数匹配对应的钩子（wp_ajax_{action}），你的JS代码未在表单数据中添加action=add_address，导致服务器无法识别要执行的函数，直接返回400错误。

2. PHP端未验证Nonce #

虽然前端传递了nonce，但后端函数add_address未做验证，这不仅存在安全漏洞，也可能触发WordPress安全拦截机制导致400错误。

3. 未终止AJAX请求 #

PHP函数执行完后未调用wp_die()或die()，WordPress会默认输出额外内容，可能导致请求异常。

4. 错误回调函数名错误 #

jQuery AJAX的错误回调应为error，原代码中的fail不会触发，导致无法捕获正确的错误信息。

代码修复方案 #

修复JavaScript代码 #

jQuery('#add_address_form').on('submit', function () {
    var form_data = jQuery(this).serializeArray();

    // 添加action参数和nonce
    form_data.push(
        { "name": "action", "value": "add_address" },
        { "name": "security", "value": ajax_nonce }
    );

    console.log('Form data:', form_data); 
    console.log('AJAX URL:', ajax_url);    

    jQuery.ajax({
        url: ajax_url, 
        type: 'post',
        data: form_data,
        success: function (response) {
            console.log('AJAX Response:', response);
            alert('提交成功');
        },
        error: function (err) {
            console.error("请求错误:", err); 
            alert("提交失败，请重试");
        }
    });

    return false;
});

修复PHP函数（functions.php） #

add_action('wp_ajax_add_address', 'add_address');
add_action('wp_ajax_nopriv_add_address', 'add_address');

function add_address()
{
    global $wpdb;

    // 验证Nonce
    if (!isset($_POST['security']) || !wp_verify_nonce($_POST['security'], 'secure_nonce_name')) {
        wp_send_json_error('无效的安全验证');
        wp_die();
    }

    // 检查必填字段
    if (!isset($_POST['address-firstname']) || !isset($_POST['address-lastname'])) {
        wp_send_json_error('缺少必填字段');
        wp_die();
    }

    // 清洗数据
    $name = sanitize_text_field($_POST['address-firstname']);
    $lastname = sanitize_text_field($_POST['address-lastname']);

    // 执行数据库插入（添加前缀避免表名冲突）
    $result = $wpdb->insert(
        $wpdb->prefix . 'pl_addresses',
        array(
            'name' => $name,
            'lastname' => $lastname,
        ),
        array('%s', '%s')
    );

    // 返回结果
    if ($result) {
        wp_send_json_success('地址添加成功');
    } else {
        wp_send_json_error('数据库插入失败: ' . $wpdb->last_error);
    }

    wp_die(); // 终止AJAX请求
}

排查与调试建议 #

• 检查浏览器Network面板：查看AJAX请求的Form Data，确认action和security参数是否正确传递；查看Response标签页的具体错误提示。
• 开启WP_DEBUG：在wp-config.php中设置define('WP_DEBUG', true);和define('WP_DEBUG_LOG', true);，错误日志会写入wp-content/debug.log，可查看服务器端具体报错。
• 验证数据库表结构：确认pl_addresses表存在，且name、lastname字段类型为VARCHAR或TEXT。
• 构造直接POST请求：手动向admin-ajax.php发送POST请求，传递action=add_address、security=你的nonce值、address-firstname=测试、address-lastname=姓名，排除前端问题。
• 排查安全插件：暂时禁用Wordfence等安全插件，测试是否因拦截导致请求失败。

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