WordPress AJAX设置processData:false上传文件时出现400错误求助

你的问题核心在于设置processData: false后，直接传递普通JavaScript对象作为请求数据，导致WordPress无法正确解析action参数——这是400错误的主要原因。因为当processData为false时，jQuery不会自动将对象转为表单编码格式，而WordPress的admin-ajax.php依赖正确的表单数据来识别要触发的action钩子。

针对文件上传场景，必须改用FormData来封装请求数据，同时配合正确的AJAX配置，具体修正如下：

一、修正JavaScript代码 #

function uploadFile() {
    const messageDiv = jQuery('.js-message')[0];
    jQuery(messageDiv).removeClass('error').empty();

    // 创建FormData对象，用于封装文件和表单数据
    const formData = new FormData();
    // 必须添加action参数，WordPress靠它找到对应的钩子
    formData.append('action', 'excel_converter');
    // 添加文件
    formData.append('file', jQuery('#excelFile')[0].files[0]);
    // 添加其他表单字段
    formData.append('addressColumn', jQuery('#addressColumn').val());
    formData.append('cityColumn', jQuery('#cityColumn').val());
    formData.append('postcodeColumn', jQuery('#postcodeColumn').val());
    formData.append('countryColumn', jQuery('#countryColumn').val());
    formData.append('latitudeColumn', jQuery('#latitudeColumn').val());
    formData.append('longitudeColumn', jQuery('#longitudeColumn').val());

    jQuery.ajax({
        url: ajax.url,
        type: 'POST',
        processData: false, // 必须保持false，避免jQuery处理FormData
        contentType: false, // 关键：不要设置contentType，让浏览器自动生成正确的multipart/form-data头
        data: formData,
        success: (response) => {
            messageDiv.append(response);
        },
        error: (xhr, status, error) => {
            jQuery(messageDiv).addClass('error');
            messageDiv.append(xhr.responseText || '请求失败');
        }
    });
}

jQuery(() => {
    const converter = jQuery('.js-excel-converter');
    if(converter.length) { // 用length判断元素是否存在，避免空对象误判
        converter.on('click', (e) => {
            e.preventDefault();
            uploadFile();
        });
    }
});

二、优化PHP代码 #

1. 把AJAX钩子从my_script_enqueuer函数中移出，避免钩子注册时机问题
2. 添加文件上传的基础处理逻辑

function excel_converter() {
    // 验证是否有文件上传
    if (!isset($_FILES['file']) || $_FILES['file']['error'] !== UPLOAD_ERR_OK) {
        echo '文件上传失败';
        wp_die(); // WordPress推荐用wp_die()替代die()
    }

    // 这里可以添加文件处理逻辑，比如读取Excel内容
    $uploaded_file = $_FILES['file']['tmp_name'];
    $file_name = $_FILES['file']['name'];

    // 示例：返回上传信息
    echo "文件 {$file_name} 上传成功，临时路径：{$uploaded_file}";
    wp_die();
}

// 单独注册AJAX钩子，不要放在enqueue函数内
add_action( 'wp_ajax_excel_converter', 'excel_converter' );
add_action( 'wp_ajax_nopriv_excel_converter', 'excel_converter' );

function my_script_enqueuer() {
    $manifest = json_decode(file_get_contents(get_template_directory() . '/dist/rev-manifest.json'), true);
    $jsFile = $manifest['app.bundle.full.js'];

    wp_enqueue_script( 'ajax-js', get_template_directory_uri() . '/dist/scripts/' . $jsFile, array('jquery') );

    wp_localize_script( 'ajax-js', 'ajax', array(
        'url' => admin_url( 'admin-ajax.php' )
    ));
}
add_action( 'wp_enqueue_scripts', 'my_script_enqueuer' ); // 用wp_enqueue_scripts代替init，这是注册脚本的正确钩子

三、额外调试建议 #

• 打开浏览器开发者工具（F12），查看网络请求中的Form Data，确认action参数是否存在且值为excel_converter
• 检查WordPress的调试日志（开启WP_DEBUG_LOG），查看admin-ajax.php返回400的具体原因
• 确保当前用户（如果是前端未登录用户）有足够的权限，wp_ajax_nopriv_*钩子已正确注册

内容的提问来源于stack exchange，提问作者Mr. Sam