PHP服务器回显文件为文本而非二进制的问题排查与解决

核心原因 #

这个问题的根源主要有两个：

1. Content-Disposition头部格式不规范
   HTTP规范要求Content-Disposition必须先明确内容的处理方式（inline让浏览器直接渲染内容，attachment触发文件下载），再附加filename参数。你的代码里只写了filename="..."，本地浏览器容错性高，能勉强识别，但服务器添加的X-Content-Type-Options: nosniff会强制浏览器严格遵循HTTP标准——浏览器无法解析不规范的头部，就会把PNG的二进制数据当成纯文本渲染，自然出现乱码。

2. 重复的Pragma头部冲突
   你先后设置了Pragma: no-cache和Pragma: public，这两个值本身冲突。本地环境可能忽略这个问题，但服务器环境下会干扰浏览器的缓存判断，间接加剧了内容解析异常。

修复步骤 #

• 修正Content-Disposition头部
  根据需求选择正确的处理方式：如果要直接显示PNG图片，改成：

  header('Content-Disposition: inline; filename="' . $fname . '"');
  

  如果需要触发下载，就把inline换成attachment。

• 清理重复的Pragma头部
  保留一个符合业务需求的Pragma值即可，比如不需要缓存就留Pragma: no-cache，允许缓存就用Pragma: public，避免冲突。

• 检查前置输出问题
  确认PHP文件开头没有BOM（字节顺序标记），执行header()之前也没有任何echo、print或空白字符——这些内容会导致HTTP头部发送异常，在X-Content-Type-Options: nosniff的严格模式下，更容易引发解析错误。

• 验证Content-Type正确性
  确保$AttachFileType对于PNG文件正确赋值为image/png，服务器环境下可能存在变量赋值错误，导致浏览器无法识别内容类型。

修复后的完整示例代码 #

// 处理方式：inline 直接显示，attachment 触发下载
header('Content-Disposition: inline; filename="' . $fname . '"');
header('Pragma: no-cache');
header('Expires: 0');
header('Cache-Control: must-revalidate, post-check=0, pre-check=0');
header("Content-type: $AttachFileType");
header("Content-Transfer-Encoding: binary");
header("Content-Length: " . filesize($ffullname));

// 确保无前置输出后读取文件
echo file_get_contents($ffullname);

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