You need to enable JavaScript to run this app. 基于PHP与jQuery的文件上传:Ajax结合FormData请求失效、控制台报readyState0错误
优惠活动
大模型
产品
解决方案
定价
更多

基于PHP与jQuery的文件上传:Ajax结合FormData请求失效、控制台报readyState0错误

故障逐点定位与修复方案

前端层面:请求被中断的核心原因(对应控制台readyState:0的报错)

控制台打印的包含readyState:0的对象是jQuery的jqXHR实例,这类异常90%以上的场景是Ajax请求还未完成就被强行终止,你的代码缺失关键的事件拦截逻辑:

  • submit事件回调中没有执行e.preventDefault(),点击提交按钮时,除了发起Ajax请求,浏览器会同时触发表单原生的同步提交行为,页面直接刷新,当前页面的JS运行上下文被销毁,尚未传输完成的Ajax请求会被直接中断,最终抛出异常。
  • 修正后前端代码的核心片段:
$(document).ready(function () {
    $("#upForm").on('submit', function (e) {
        // 必须放在函数第一行,优先阻止原生表单提交
        e.preventDefault()
        $.ajax({
            type: 'POST',
            dataType: 'JSON',
            url: '/data/controls.php',
            processData: false,
            contentType: false,
            cache: false,
            data: new FormData(this),
            success: function (response) {
                console.log(response);
            },
            error: function (response) {
                console.log(response)
            }
        })
    })
})

补充说明:你当前使用的new FormData(this)写法是完全正确的,事件回调中的this指向当前监听的表单DOM元素,可直接用来初始化FormData,不需要额外调整。

后端层面:逻辑bug导致返回值无效

即使前端请求顺利发出,当前PHP代码的多处问题也会导致jQuery无法正常解析返回值,核心问题有三处:

  1. 状态判断误用赋值运算符
    代码中写的if ($response['status'] = 1)是单等号的赋值操作,不是相等比较,会直接强行把status改为1,导致原本的上传成功/失败状态判断逻辑完全失效,哪怕上传失败也会强制进入数据库写入分支。
  2. JSON重复输出导致格式无效
    POST分支内部已经执行了一次echo json_encode($response);,代码最外层又不区分请求类型执行了一次echo json_encode($response);,最终返回给前端的内容是两份JSON字符串拼接的无效格式,jQuery按照dataType: JSON解析时会直接失败,走到error分支抛出jqXHR对象的报错。
  3. 状态映射逻辑错位
    原本上传成功时把status设为1、配套提示写的是上传失败,和后续数据库写入完成后设置的status=3逻辑完全脱节,调试时很容易误判上传状态。
  • 修正后的后端核心逻辑片段:
$uploadDir = "../upload/";
$response = array(
    'status' => 0,
    'message' => 'Oops!'
);

if ($_SERVER["REQUEST_METHOD"] == "POST"){
    // 增加文件存在性校验,避免无文件时的PHP报错
    if (!isset($_FILES['file']) || $_FILES['file']['error'] !== UPLOAD_ERR_OK) {
        $response['message'] = '文件读取失败';
        echo json_encode($response);
        exit;
    }

    // 校验文件大小
    if ($_FILES['file']['size'] > 3000000){
        $response['status'] = 0;
        $response['message'] = 'File size too big!';
    } else {
        $allowedTypes = array('jpg', 'png', 'jpeg', 'gif');
        $fileName = basename($_FILES['file']['name']);
        $filePath = $uploadDir . $fileName;
        $fileType = strtolower(pathinfo($filePath, PATHINFO_EXTENSION));

        if (in_array($fileType, $allowedTypes)){
            if(move_uploaded_file($_FILES['file']['tmp_name'], $filePath)){
                // 上传成功后再执行数据库写入
                $PDOinst= DBconnect::getInstance();
                $PDO = $PDOinst->getConnection();
                $sqlString = "INSERT INTO fileUpload values (NULL, :fname, :size, :upDate)";
                $query = $PDO->prepare($sqlString);
                $paramArray = array(
                    'fname' => $_FILES['file']['name'],
                    'size' => $_FILES['file']['size'],
                    'upDate' => date("d-m-Y (G:i)")
                );
                $query->execute($paramArray);
                $response['status'] = 3;
                $response['message'] = 'File uploaded successfully!';
            } else {
                $response['message'] = '文件移动失败,请检查上传目录读写权限';
            }
        } else {
            $response['status'] = 2;
            $response['message'] = 'File format not allowed!';
        }
    }
    // POST分支内仅输出一次JSON,输出后终止脚本避免重复内容
    echo json_encode($response);
    exit;
}

// 非POST请求的返回单独输出,不与POST分支的内容重叠
echo json_encode($response);
exit;

额外排查项

  • 确认../upload/目录的读写权限,保证PHP进程可以写入文件,否则move_uploaded_file会返回false
  • 确认Ajax请求的URL路径匹配实际项目部署路径,如果项目部署在子目录下,当前写的绝对路径/data/controls.php会触发404,导致请求失败

内容的提问来源于stack exchange,提问作者cybercivizen

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.04 09:54:02