本文探讨了在使用pdf.js处理流式传输的pdf文件时，可能遇到的“无效或损坏的pdf文件”错误。重点分析了导致此问题出现的潜在原因，特别是服务器环境（如本地iis与生产服务器）配置差异的影响。文章提供了php文件流传输代码示例，并提出了针对此类间歇性问题的诊断与排查策略，强调了验证服务器配置和http头部的重要性，以确保文件传输的完整性。
理解问题现象与错误信息
在使用pdf.js库在浏览器中预览PDF文件时，有时会遇到间歇性的“Invalid or corrupted PDF file”或“Invalid PDF structure”错误。这种问题尤其常见于通过服务器端脚本进行流式传输的PDF文件，而非直接访问静态文件。用户可能会观察到部分PDF文件正常显示，部分间歇性失败，甚至有些文件完全无法显示，尽管这些文件在本地使用Adobe Acrobat等阅读器时均能正常打开。这通常表明问题并非出在PDF文件本身，而可能与文件在传输过程中的完整性或服务器配置有关。
文件流传输机制分析
在Web应用中，为了实现对文件的访问控制、部分内容传输或处理，常常需要通过服务器端脚本（如PHP）来读取文件并将其作为HTTP响应流式传输给客户端。以下是一个典型的PHP文件流传输函数smartReadFile，它支持HTTP范围请求（HTTP_RANGE），允许客户端请求文件的部分内容，这对于大型文件或断点续传功能至关重要。
function smartReadFile($location, $filename, $mimeType = 'application/octet-stream')
{
if (!file_exists($location))
{
header ("HTTP/1.1 404 Not Found");
return;
}
$size = filesize($location);
$time = date('r', filemtime($location));
$fm = @fopen($location, 'rb');
if (!$fm)
{
header ("HTTP/1.1 505 Internal server error"); // 应为500 Internal Server Error
return;
}
$begin = 0;
$end = $size - 1;
// 处理HTTP范围请求
if (isset($_SERVER['HTTP_RANGE']))
{
if (preg_match('/bytes=\h*(\d+)-(\d*)[\D.*]?/i', $_SERVER['HTTP_RANGE'], $matches))
{
$begin = intval($matches[1]);
if (!empty($matches[2]))
{
$end = intval($matches[2]);
}
}
}
// 设置HTTP状态码和头部
if (isset($_SERVER['HTTP_RANGE']))
{
header('HTTP/1.1 206 Partial Content'); // 部分内容
}
else
{
header('HTTP/1.1 200 OK'); // 完整内容
}
header("Content-Type: $mimeType");
header('Cache-Control: public, must-revalidate, max-age=0');
header('Pragma: no-cache');
header('Accept-Ranges: bytes');
header('Content-Length:' . (($end - $begin) + 1)); // 传输内容的实际长度
if (isset($_SERVER['HTTP_RANGE']))
{
header("Content-Range: bytes $begin-$end/$size"); // 告知客户端传输范围和总大小
}
if(isset($_REQUEST['SaveAs']) && $_REQUEST['SaveAs'] == "1"){
header('Content-Disposition: attachment; filename=' . $filename); // 下载
}else{
header("Content-Disposition: inline; filename=\"$filename\""); // 在线预览
}
header("Content-Transfer-Encoding: binary");
header("Last-Modified: $time");
// 读取文件并输出
$cur = $begin;
fseek($fm, $begin, 0);
while(!feof($fm) && $cur <= $end && (connection_status() == CONNECTION_NORMAL)) // 使用CONNECTION_NORMAL更准确
{
print fread($fm, min(1024 * 16, ($end - $cur) + 1)); // 分块读取，每次16KB
$cur += 1024 * 16;
}
fclose($fm); // 关闭文件句柄
}此函数通过设置正确的HTTP头部（如Content-Type、Content-Length、Content-Range等），并以块（chunk）的形式读取文件内容并输出，以实现高效的文件传输。
潜在问题根源探讨
当上述流式传输机制导致pdf.js报错时，问题往往不直接出在前端库，而是后端传输环节。以下是几个常见的潜在根源：
1. 服务器配置差异
这是最常见且最隐蔽的原因。本地开发环境（如Windows上的IIS）与生产环境（如Linux上的Apache/Nginx + PHP-FPM）在默认配置上存在显著差异：
- PHP执行限制: php.ini中的memory_limit（内存限制）、max_execution_time（最大执行时间）和output_buffering（输出缓冲）等设置。如果文件过大或传输时间过长，可能导致PHP脚本在传输完成前被终止，从而发送不完整的PDF数据。
- Web服务器配置: IIS、Apache或Nginx可能有自己的超时设置、缓冲区大小限制或模块配置，这些都可能影响长连接或大文件的传输。例如，IIS的FastCGI模块可能对请求处理时间有默认限制。
- MIME类型配置: 确保服务器正确地将.pdf文件映射到application/pdfMIME类型。虽然流式传输中PHP会显式设置Content-Type，但服务器的全局配置仍可能产生影响。
- 网络堆栈/驱动: 本地开发环境的网络设置可能与生产环境不同，某些防火墙或安全软件也可能干扰文件流。
2. 文件传输完整性问题
- 网络中断: 客户端与服务器之间的网络不稳定可能导致数据包丢失或连接中断，尤其是在传输大文件时。
- PHP输出缓冲: 如果PHP的output_buffering开启，并且没有及时flush()输出缓冲区，可能导致数据在服务器端累积，而不是实时发送给客户端，这可能会在某些超时情况下导致问题。
- connection_status()误判: 在smartReadFile函数中，connection_status()在某些服务器或PHP版本上可能无法准确反映客户端连接状态，导致脚本在客户端断开后仍在继续发送数据，或反之。
3. PDF文件本身的特性
尽管问题描述中提到文件在Acrobat中正常打开，但某些PDF文件可能包含非标准结构或损坏的部分，这些在某些PDF阅读器中可能被容忍，但在严格的pdf.js解析器中则可能触发错误。然而，鉴于问题是间歇性的且与环境相关，这通常不是主要原因。
诊断与排查策略
针对此类间歇性PDF流传输问题，可以采取以下策略进行诊断和排查：
简化测试环境，隔离问题: 最有效的策略是在不同服务器环境（尤其是生产环境）上测试相同的代码和文件。如果问题在生产环境消失，则强烈表明问题出在开发环境的服务器配置上。这是从原始问题中得出的关键结论。
-
检查服务器日志:
- PHP错误日志: 查看php-error.log，寻找脚本执行超时、内存溢出或其他PHP运行时错误。
- Web服务器日志: 检查IIS日志（或Apache/Nginx错误日志），寻找HTTP 5xx错误、连接中断或与请求处理相关的警告。
-
使用浏览器开发者工具检查HTTP头部: 在浏览器中打开开发者工具（F12），切换到“网络”或“Network”选项卡。重新加载PDF文件，检查：
- HTTP状态码: 确保是200 OK（完整内容）或206 Partial Content（部分内容）。
- Content-Type: 必须是application/pdf。
- Content-Length: 检查其值是否与实际传输的文件大小匹配。如果使用了Content-Range，Content-Length应是请求范围的长度。
- Content-Range: 如果是部分内容请求，检查其格式是否正确，如bytes 0-1000/2000。
- 其他头部: Accept-Ranges: bytes、Content-Transfer-Encoding: binary等是否正确设置。
- 响应体: 尝试将响应体保存为文件，并用本地PDF阅读器打开，看是否完整或损坏。
-
逐步排查PHP脚本:
- 移除@操作符: 在fopen等可能出错的函数前移除@，以便捕获并记录潜在的PHP警告或错误。
- 强制刷新输出缓冲区: 在while循环内部，可以尝试添加ob_flush(); flush();来强制PHP将缓冲区内容发送到客户端。但需注意，这可能影响性能，且在某些服务器配置下可能无效。
- 简化文件读取: 尝试暂时移除HTTP_RANGE处理逻辑，只进行完整文件传输，看问题是否复现。这有助于判断问题是否与部分内容传输机制有关。
对比php.ini和Web服务器配置: 如果问题在不同环境间存在，仔细对比php.ini文件以及Web服务器（IIS配置文件、Apache的httpd.conf、Nginx的nginx.conf）的相关配置项，尤其是与超时、内存、缓冲区和文件传输相关的设置。
总结与建议
当pdf.js间歇性报告“无效或损坏的PDF文件”时，尽管错误信息指向PDF本身，但实际问题往往出在服务器端的文件流传输环节。核心思路是将问题从前端转移到后端，再从后端代码转移到后端服务器配置。
- 优先检查服务器环境: 像本例一样，将代码部署到已知的稳定生产环境进行测试，是快速定位问题根源的有效方法。如果问题消失，则将重心放在对比开发环境与生产环境的服务器配置差异上。
- 确保HTTP头部正确无误: 错误的Content-Length、Content-Type或缺失的Content-Range头部都可能导致客户端（包括pdf.js）无法正确解析接收到的数据。
- 关注服务器资源限制: PHP的内存限制、执行时间限制以及Web服务器的连接超时、缓冲区大小等都可能导致文件传输不完整。
通过系统化的排查和对比，通常能够找出导致流式PDF文件损坏或无效的根本原因，从而确保pdf.js能够稳定可靠地渲染PDF文档。
