PHP & ZipArchive()加载PDF文档失败问题求助

嘿，我来帮你排查这个PDF加载失败的问题！咱们一步步拆解可能的原因，从服务器端到前端逐个验证：

1. 先确认PDF文件的路径与权限 #

• 首先试试直接在浏览器地址栏输入PDF的完整URL（比如http://你的域名/存储路径/测试文件.pdf），如果直接访问也失败，那大概率是路径错误或者服务器权限不足：
  • 检查arquivo.php返回的路径是不是Web服务器能识别的路径（要相对于网站根目录，不能用本地磁盘路径比如C:\xxx\file.pdf）；
  • 给PDF所在文件夹设置Web服务器进程的读取权限（比如Apache的www-data用户，Nginx的nginx用户）。

2. 检查arquivo.php的判断逻辑 #

• 确保它识别PDF/ZIP的逻辑没问题：比如用pathinfo($file, PATHINFO_EXTENSION)获取扩展名时，有没有转成小写（避免.PDF这种大写扩展名被误判），或者用更可靠的MIME类型检测（finfo_file()）；
• 注意arquivo.php不能输出多余内容！比如调试用的echo、空格甚至?>之后的换行，都会破坏后续的响应，建议在输出PDF路径前加上ob_clean();清空缓冲区。

3. 验证pdf.php的响应头设置 #

如果pdf.php是负责输出PDF内容的，必须配置正确的HTTP响应头，否则浏览器无法识别：

// 示例正确的响应头配置
$pdfPath = '你获取到的PDF路径';
if (file_exists($pdfPath)) {
    // 清空缓冲区，避免多余输出
    ob_clean();
    // 设置正确的内容类型
    header('Content-Type: application/pdf');
    // 让浏览器在窗口内打开，而不是下载
    header('Content-Disposition: inline; filename="' . basename($pdfPath) . '"');
    // 告诉浏览器文件大小
    header('Content-Length: ' . filesize($pdfPath));
    // 输出文件内容
    readfile($pdfPath);
    exit;
} else {
    header("HTTP/1.0 404 Not Found");
    echo "PDF文件不存在";
}

• 记得去掉php文件末尾的?>，避免后面的换行被输出；
• 如果服务器开启了Gzip压缩，可能会导致PDF加载异常，可以加上header('Content-Encoding: none');禁用压缩试试。

4. 前端弹出窗口的细节 #

• 检查传递参数时有没有转义特殊字符：如果文件名包含空格、中文或者特殊符号，必须用encodeURIComponent()处理，比如：

const targetUrl = 'pdf.php?file=' + encodeURIComponent(你的文件路径参数);
window.open(targetUrl, '_blank');

• 确认浏览器没有阻止弹出窗口，测试时可以暂时允许网站的弹窗权限，看是否能正常加载。

5. 排除PDF文件本身的问题 #

试试用本地阅读器打开目标PDF，确认文件没有损坏；或者替换成一个已知正常的测试PDF，看是否能正常加载，排除文件损坏的可能。

如果按上面的步骤排查后还是有问题，可以把arquivo.php和pdf.php的关键代码片段贴出来，这样能更精准地定位问题！

内容的提问来源于stack exchange，提问作者user8336795