使用PHP的readfile函数无法正常下载图片问题求助

我遇过好几个类似的情况，你的代码框架看起来没问题，但下载后的文件打不开，大概率是额外的输出内容污染了文件流，或者HTTP头的细节没处理到位。下面给你一步步排查和修复的方案：

1. 清理输出缓冲与多余空白 #

最常见的原因是PHP文件里存在意外的空白字符（比如<?php标签前的空格、换行，或者?>标签后的内容），这些空白会被输出到HTTP响应中，混进下载的图片数据里，直接导致文件损坏。

解决办法：

• 去掉PHP文件末尾的?>标签（PHP本身不需要这个闭合标签，反而容易带来空白问题）
• 在输出HTTP头之前，强制清理输出缓冲，添加这两行代码：

  ob_clean();
  flush();
  

2. 优化HTTP头设置 #

你的Content-Type用了application/octet-stream虽然通用，但针对图片可以设置更准确的MIME类型，同时确保Content-Length的计算逻辑可靠：

• 对于jpg图片，Content-Type改成image/jpeg，能避免部分浏览器的解析异常
• 确保文件路径绝对正确，如果test.jpg不在当前脚本所在目录，要用绝对路径（比如$_SERVER['DOCUMENT_ROOT'] . '/uploads/test.jpg'）

3. 修正后的完整代码 #

<?php
$file = 'test.jpg';

// 先做基础校验：确保文件存在且可读
if (!file_exists($file) || !is_readable($file)) {
    die('文件不存在或无法读取');
}

// 清理输出缓冲，避免多余内容混入
ob_clean();
flush();

header('Content-Description: File Transfer');
header('Content-Type: image/jpeg'); // 更精准的图片MIME类型
header('Content-Disposition: attachment; filename="'.basename($file).'"');
header('Expires: 0');
header('Cache-Control: must-revalidate');
header('Pragma: public');
header('Content-Length: ' . filesize($file));

// 输出文件内容后直接终止脚本，防止后续输出
readfile($file);
exit;
?>

4. 额外排查点 #

• 检查PHP错误输出：如果脚本有警告（比如文件权限问题），错误信息会偷偷写入响应流，损坏文件。可以临时关闭错误输出调试：error_reporting(0);（调试完成后记得恢复）
• 确认文件权限：确保PHP进程拥有读取test.jpg的权限（比如Linux下设置正确的用户组权限）

按照这个方案修改后，应该就能正常下载并打开图片了。

内容的提问来源于stack exchange，提问作者Noë Perracini