
PHP+Nginx大文件下载损坏问题及解决方案
在使用PHP、Nginx和云存储服务(例如华为云OBS)构建文件下载系统时,经常遇到大文件下载损坏的问题:小文件下载正常,但大文件(例如超过5MB)下载后损坏,无法解压。即使文件大小正确,问题依然存在。本文分析原因并提供解决方案。
问题描述:
开发者使用分片下载技术从云存储下载文件时,发现大文件下载损坏。小文件正常,大文件损坏,无法解压,但文件大小与源文件一致。初步排查怀疑数据传输或处理过程中出现顺序错乱或数据丢失。代码使用了异步方式获取文件内容,并尝试写入本地文件再输出,但问题依旧。
立即学习“PHP免费学习笔记(深入)”;
问题分析与解决方案:
原代码使用云存储SDK的异步方法进行分片下载。测试发现,异步方法直接输出到浏览器时,数据顺序错乱导致文件损坏。将数据写入本地文件后再输出则能解决问题,说明问题并非源文件或网络传输问题,而是异步操作导致的数据处理顺序问题。
解决方案是将异步方法替换为同步方法,保证数据顺序性。
改进后的代码:
getObject([
'Bucket' => $bucket,
'Key' => $fileInfo['url'],
'Range' => $range,
]);
try {
while (!$resp['Body']->eof()) {
$str = $resp['Body']->read(655360);
echo $str;
if (ob_get_level() > 0) {
ob_flush();
flush();
}
}
} catch (Exception $exception) {
//printf($exception);
}
$resp['Body']->close();
}
$obsClient->close();
exit();
?>
通过使用同步方法获取文件内容并直接输出,解决了大文件下载损坏问题。异步操作处理大文件流时,并发问题可能导致数据顺序错乱,从而损坏文件。同步方式有效避免了这个问题。











