AJAX上传文件设置contentType/processData为false后PHP POST为空

你遇到的问题核心是FormData的使用方式错误——你把FormData对象嵌套在了普通的JavaScript对象里，这和contentType: false、processData: false的配置冲突了，导致jQuery无法正确解析并发送请求数据。

为什么会出错？ #

当你设置processData: false时，jQuery不会尝试把你的data对象转换为查询字符串；而contentType: false是让浏览器自动根据FormData设置正确的multipart/form-data请求头。但如果你的data是{action: "...", profilePicture: formData}这种嵌套结构，jQuery没办法处理这种包含FormData的普通对象，最终发送的请求数据格式完全不符合服务器预期，所以PHP端收不到正确的POST数据。

正确的做法 #

你需要把所有需要发送的字段（包括action）都直接append到FormData对象里，然后把FormData直接作为AJAX的data参数值：

var formData = new FormData();
// 先append文件
formData.append('image', input.files[0]);
// 再append其他业务字段
formData.append('action', 'changeProfilePicture');

$.ajax({
    url: "php/API.php",
    data: formData, // 直接传FormData对象
    type: "POST",
    contentType: false,
    processData: false,
    success: function(response) {
        // 处理成功回调
        console.log('上传成功:', response);
    },
    error: function(xhr, status, error) {
        // 处理错误
        console.error('上传失败:', error);
    }
});

PHP端的接收方式 #

在你的API.php里，就可以正常通过$_POST['action']拿到业务标识，通过$_FILES['image']拿到上传的文件了：

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    if (isset($_POST['action']) && $_POST['action'] === 'changeProfilePicture') {
        // 处理文件上传
        if (isset($_FILES['image']) && $_FILES['image']['error'] === UPLOAD_ERR_OK) {
            $uploadedFile = $_FILES['image'];
            // 这里写你的文件处理逻辑，比如移动到指定目录
            $targetPath = 'uploads/' . basename($uploadedFile['name']);
            if (move_uploaded_file($uploadedFile['tmp_name'], $targetPath)) {
                echo json_encode(['success' => true, 'message' => '文件上传成功']);
            } else {
                echo json_encode(['success' => false, 'message' => '文件移动失败']);
            }
        } else {
            echo json_encode(['success' => false, 'message' => '文件上传出错']);
        }
    }
}

额外注意点 #

• 确保你的HTML表单（如果有的话）设置了enctype="multipart/form-data"，不过因为你用AJAX+FormData，这个其实不是必须的，但加上更规范。
• 检查服务器的上传文件大小限制（php.ini里的upload_max_filesize和post_max_size），避免因为文件过大导致上传失败。

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