Laravel DomPDF stream()方法异常：浏览器下载而非预览PDF

我之前也踩过这个坑，明明调用了stream()却还是弹出下载框，折腾了好一会儿才摸清楚几个靠谱的解决方向，给你一一列出来：

1. 明确指定 inline 处置模式 #

有时候默认的stream()行为会被框架中间件或配置覆盖，导致Content-Disposition头被设为attachment（强制下载）。你可以直接在stream()方法里传入参数，强制开启预览模式：

$pdf = PDF::loadView('admin.cetak', compact('data'));
// 第二个参数传入配置数组，明确设置不强制下载
return $pdf->setPaper('a4')->stream('cetak.pdf', ['Attachment' => false]);

这里的['Attachment' => false]是核心，它会让Dompdf输出inline类型的响应头，告诉浏览器直接预览而非下载。

2. 手动构建响应头兜底 #

如果上面的方法无效，可以绕过Dompdf的stream()，直接用Laravel的response()方法手动设置所有必要的响应头：

$pdf = PDF::loadView('admin.cetak', compact('data'));
$pdf->setPaper('a4');

return response($pdf->output(), 200, [
    'Content-Type' => 'application/pdf',
    'Content-Disposition' => 'inline; filename="cetak.pdf"',
    'Cache-Control' => 'no-cache, no-store, must-revalidate', // 避免浏览器缓存旧头
    'Pragma' => 'no-cache',
    'Expires' => '0'
]);

3. 更新 Laravel-Dompdf 到最新版 #

旧版本的包可能存在stream()方法的头信息bug，比如错误设置了处置类型。你可以通过Composer更新到稳定版：

composer update barryvdh/laravel-dompdf

4. 排除浏览器/服务器缓存干扰 #

有时候浏览器会缓存旧的响应头，导致一直触发下载。可以试试：

• 用浏览器的无痕模式测试
• 临时添加禁用缓存的响应头（如上面代码中的Cache-Control相关配置）

5. 检查自定义中间件的影响 #

如果你的应用有修改响应头的自定义中间件（比如处理CORS、统一响应格式的中间件），可能会无意中覆盖了PDF的处置头。可以临时禁用这类中间件，测试问题是否消失。

优先试试第一种方法，直接在stream()里传Attachment参数，这个通常能快速解决问题。

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