PHP文件上传时大于1MB文件被重复写入上传目录且无提示求助
大文件上传异常排查与解决思路
优先核对PHP上传核心配置
超过1M触发异常的特征,首先要检查PHP上传相关配置是否符合需求:
- 核对
upload_max_filesize(单文件上传大小限制)、post_max_size(POST请求总大小限制)、max_execution_time(脚本最长执行时间)、max_input_time(接收POST数据的最长等待时间)四个参数的实际生效值 - 注意
post_max_size必须大于upload_max_filesize,否则文件接近限制时PHP会清空$_FILES、$_POST数组,不会抛出可捕获的上传错误,直接中断响应 - 大文件上传场景下,默认30s的执行/输入超时很容易触发脚本中断,需要根据实际支持的文件大小调整对应数值
- 可通过
phpinfo()确认配置是否实际生效,避免修改php.ini后未重启服务的问题
修复现有上传代码的逻辑缺陷
现有代码存在多处可直接触发异常的逻辑漏洞:
完全未校验上传错误码
所有PHP上传文件都会自带error标识,0代表上传成功,其余值对应各类失败原因(比如1是超过ini限制、3是部分上传、7是临时文件写入失败等),当前代码不校验该值,即使上传失败也会执行后续流程。
需在move_uploaded_file前增加校验:if ($_FILES['img']['error'][$i] !== UPLOAD_ERR_OK) { $json['error'] = '上传失败,错误码:' . $_FILES['img']['error'][$i]; break; }重写
$_FILES的逻辑存在结构错误
现有代码循环遍历$this->request->files时,直接给$_FILES['img']['name']、$_FILES['img']['tmp_name']赋值,未按PHP的$_FILES规范组装为数组结构,多文件上传时会出现值被覆盖、count()判断失真的问题,导致循环逻辑异常。
建议移除直接覆盖超全局变量的逻辑,统一组装文件数组:$upload_files = []; foreach ($this->request->files as $key => $value) { $upload_files = array_merge($upload_files, is_array($value['name']) ? $value : [$value]); }未校验文件移动函数的返回值
move_uploaded_file执行失败会返回false(比如目标目录无写入权限、临时文件已被清理),当前代码不判断返回值,依然返回成功提示,会导致前端误判上传失败触发重试。
需增加返回值校验:if (!move_uploaded_file($_FILES['img']['tmp_name'][$i], DIR_DOWNLOAD . $newname)) { $json['error'] = '文件写入失败,请检查存储目录权限'; break; }响应逻辑冲突
现有代码在else分支设置了$json['error'],但无论是否存在错误都会强制赋值$json['success'],会导致前端同时收到错误和成功标识,判断逻辑混乱触发重试。需把success的赋值放在无错误的分支下。
排查前端重试触发原因
- 大文件上传时如果服务端响应超时、返回非JSON格式的错误页、HTTP状态码为500/504,前端上传组件会默认自动重试,直接导致同一文件被反复上传、目录堆积重复文件。
- 可打开浏览器开发者工具,查看超过1M文件上传时的请求状态:如果看到请求Pending超时、响应为空、返回HTML错误页而非预期JSON,就说明是服务端配置限制或脚本超时导致的响应中断。
内容的提问来源于stack exchange,提问作者Adeel Javed
相关产品推荐
相关产品推荐

