Chrome浏览器中PHP生成PNG图片保存出现“Failed - Network error”问题

问题重现 #

我通过PHP生成图片并输出，代码如下：

$im = imagecreatetruecolor($w,$h);
...
header('Content-type: image/png');
header('Cache-Control: no-store, no-cache');
imagepng($im);
imagedestroy($im);

在Chrome浏览器右键选择“图片另存为...”时，会出现“Failed - Network error”提示，无法保存图片；但FireFox、Safari或IE中操作正常。尝试添加header('Content-disposition: inline; filename=image.png');后，问题仍未解决，Chrome还会将保存文件名显示为生成图片的PHP文件名（后缀为.php），而非.png。

问题原因及解决方法 #

1. Cache-Control头的兼容性问题
   Chrome对no-store, no-cache的处理逻辑和其他浏览器不同，这个头会完全禁止浏览器缓存图片，导致另存为操作时无法读取缓存的图片数据。建议替换为：

header('Cache-Control: private, max-age=0');

这个配置允许浏览器临时缓存图片，满足另存为的需求，同时不会长期存储缓存内容。

2. HTTP头的大小写规范
   Chrome对HTTP头的大小写敏感，Content-disposition需要写成标准的Content-Disposition（首字母大写），否则无法正确识别filename参数。同时推荐给文件名加上双引号，避免特殊字符导致的解析问题：

header('Content-Disposition: inline; filename="image.png"');

3. 确保输出无多余内容
   检查PHP文件的开头、结尾以及图片绘制代码前后，有没有多余的空格、换行或者BOM头。这些内容会导致HTTP头输出不完整，Chrome无法正确解析图片响应。最后建议加上exit;确保后续没有额外输出。

修正后的完整代码示例 #

$im = imagecreatetruecolor($w,$h);
// 这里添加你的图片绘制逻辑，比如填充颜色、绘制文字等

// 输出正确的HTTP头
header('Content-Type: image/png');
header('Cache-Control: private, max-age=0');
header('Content-Disposition: inline; filename="image.png"');

// 输出图片并销毁资源
imagepng($im);
imagedestroy($im);
exit;

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