基于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无法正常解析返回值,核心问题有三处:
- 状态判断误用赋值运算符
代码中写的if ($response['status'] = 1)是单等号的赋值操作,不是相等比较,会直接强行把status改为1,导致原本的上传成功/失败状态判断逻辑完全失效,哪怕上传失败也会强制进入数据库写入分支。 - JSON重复输出导致格式无效
POST分支内部已经执行了一次echo json_encode($response);,代码最外层又不区分请求类型执行了一次echo json_encode($response);,最终返回给前端的内容是两份JSON字符串拼接的无效格式,jQuery按照dataType: JSON解析时会直接失败,走到error分支抛出jqXHR对象的报错。 - 状态映射逻辑错位
原本上传成功时把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
相关产品推荐
相关产品推荐

