JavaScript通过XMLHttpRequest Blob上传100MB图片到PHP出现文件损坏
100MB图片上传后字节丢失、文件损坏的修复方案
问题根源
现有前后端实现存在多处逻辑错误,直接触发文件截断、内容损坏的现象:
- 前端编码逻辑错位:通过
readAsDataURL读取文件会生成base64格式的文本字符串,后续自定义的mySendAsBinary方法会把这段文本的每个ASCII字符按字节转换后发送,本质上传的是base64文本的编码内容,不是图片本身的二进制数据。加上逐字符循环转换的实现对100MB级大文件的内存占用极高,跨浏览器处理超长文本时极易出现尾部内容截断。 - 服务端流读取逻辑失效:
fgets逐行读取二进制流是根本性错误——fgets遇到流中的换行符就会提前结束当前块的读取,根本无法完整遍历二进制内容。同时循环内逐块base64解码的逻辑不符合编码规范:base64存在严格的块对齐要求,将完整的base64串拆成4096字节的小块单独解码,会产生大量无效字节,直接破坏文件内容。 - 环境配置阈值不匹配:PHP默认的上传大小、内存占用、执行超时阈值远低于100MB文件的处理要求,超过阈值的请求会被PHP静默截断,不会返回明确的4xx错误状态,因此会出现接口返回200但保存的文件不完整的现象。
前端实现修复
彻底废弃原有手动转码的冗余逻辑,直接将选中的File对象作为Blob发送,可将大文件上传的内存开销降低60%以上,正确实现如下:
const fileInput = document.getElementById("selectedfile"); const uploadFile = fileInput.files[0]; const xhr = new XMLHttpRequest(); // 对文件名做URL编码,避免特殊字符导致请求异常 xhr.open("POST", `uprx.php?filename=${encodeURIComponent(uploadFile.name)}`, true); // 原有进度监听逻辑可保留,无功能问题 xhr.upload.addEventListener("progress", (e) => { const percent = Math.round((e.loaded / e.total) * 100); // 此处更新上传进度UI }); xhr.onreadystatechange = () => { if (xhr.readyState === 4) { if (xhr.status === 200) { // 处理上传成功逻辑 } else { // 处理上传异常逻辑 } } }; // 直接发送原始文件Blob,不需要任何手动转码 xhr.send(uploadFile);
注意:不要手动设置表单类的Content-Type请求头,让XHR自动为Blob请求匹配正确的二进制流头,避免编码错位。
服务端实现修复
废弃原有fgets逐行读取、循环内逐块base64解码的错误逻辑,正确实现如下:
- 首先对获取到的文件名做合法性校验,避免路径穿越安全漏洞
- 按固定二进制块读取输入流,逐块写入文件,不要逐行读取
// 生成安全的保存路径,避免路径穿越 $safeFilename = basename($_GET["filename"]); $saveDir = __DIR__ . "/uploads"; // 确保上传目录存在且有读写权限 if (!is_dir($saveDir)) mkdir($saveDir, 0755, true); $savePath = $saveDir . "/" . $safeFilename; $inputHandler = fopen("php://input", "r"); $fileHandler = fopen($savePath, "w"); // 按8KB固定块读取二进制流,替换原有fgets逐行读的错误逻辑 while (!feof($inputHandler)) { $buffer = fread($inputHandler, 8192); fwrite($fileHandler, $buffer); } fclose($inputHandler); fclose($fileHandler);
如果业务必须走base64传输逻辑,必须等所有输入内容全量读入内存后,再统一做前缀替换、base64解码操作,绝对不能在循环内逐块解码:
$safeFilename = basename($_GET["filename"]); $savePath = __DIR__ . "/uploads/" . $safeFilename; // 全量读取所有POST输入内容 $rawInput = file_get_contents("php://input"); // 统一去掉所有格式的base64前缀 $base64Str = preg_replace('#^data:image/\w+;base64,#i', '', $rawInput); // 统一完成base64解码 $imageData = base64_decode($base64Str); // 一次性写入文件 file_put_contents($savePath, $imageData);
环境配置调整
必须修改php.ini中的对应参数,否则100MB文件上传必然被静默截断,参考配置值如下:
post_max_size = 120M:预留文件大小+请求元数据的余量,避免超过POST请求的大小限制upload_max_filesize = 120M:匹配文件大小要求memory_limit = 256M:给PHP预留足够的内存处理大输入流,避免内存溢出max_execution_time = 300:给大文件上传留足处理时间,避免请求超时被中断- 确认
enable_post_data_reading = On:确保PHP会完整读取POST输入流,否则php://input无法获取完整内容
内容的提问来源于stack exchange,提问作者Janusz Gerszberg
相关产品推荐
相关产品推荐

