使用PHP实现PDF下载功能 下载后文件无法打开如何解决

排查步骤 #

• 检查是否有意外输出混入PDF内容：PHP发送header前如果存在echo、var_dump等输出，或者PHP文件开头/结尾有多余的空格、换行、UTF-8 BOM头，都会污染PDF文件结构。可以直接用文本编辑器打开下载的PDF，确认开头是否是PDF标准头%PDF-，如果有其他内容就是输出污染的问题，可以在发送header前加ob_end_clean()清空输出缓冲区解决。
• 检查临时文件生成逻辑是否正确：原有代码rename($tmp, $tmp .= '.pdf');的执行顺序存在隐患，会先给$tmp拼接.pdf后缀再执行重命名，可能出现重命名失败、文件不存在的问题，导致readfile读取不到有效内容。
• 检查文件名编码是否合规：如果$nomeDoPdf包含中文、空格或特殊字符，未编码会导致Content-Disposition头异常，部分浏览器下载的文件内容会出现损坏。
• 检查dompdf渲染是否正常：可以先跳过下载逻辑，直接把服务器上生成的临时PDF文件下载下来打开，如果原文件本身无法打开，说明是dompdf渲染环节出错，需要检查渲染用到的数据源、外部资源（图片、自定义字体）是否存在，开启dompdf debug模式排查渲染报错。
• 检查头信息是否完整：缺少Content-Length头可能导致浏览器下载文件不全，触发文件损坏报错。

修复后可用代码示例 #

$dompdf->render();
$arquivo = $dompdf->output();

// 清空所有前置输出，避免额外字符混入PDF
ob_end_clean();

$tmp = tempnam(sys_get_temp_dir(), "pdf");
file_put_contents($tmp, $arquivo);
$pdfPath = $tmp . '.pdf';
// 修正重命名逻辑
rename($tmp, $pdfPath);

// 补全正确的响应头
header("Content-Type: application/pdf");
$filename = basename($nomeDoPdf);
// 兼容多语言特殊字符的文件名
header("Content-Disposition: attachment; filename*=UTF-8''" . rawurlencode($filename));
header("Content-Length: " . filesize($pdfPath));
header("Cache-Control: private, max-age=0, must-revalidate");
header("Pragma: public");

readfile($pdfPath);
// 下载完成后删除临时文件，避免占用服务器空间
unlink($pdfPath);
// 终止后续输出
exit;

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