Laravel中Storage::response()触发PDF下载而非在线显示问题求助

问题 #

使用Laravel的Storage::response()方法尝试在浏览器中在线显示PDF，但浏览器始终触发下载而非在线预览，代码如下：

return Storage::disk('public')->response(
    $path,
    $responseFileName,
    ['Content-Type' => 'application/pdf'],
    'inline'
);

路由为GET请求，预期PDF在线打开，实际触发下载，需排查问题点。

原因分析与解决方案 #

你的代码参数顺序是正确的，但问题出在响应头的组合设置，以及部分环境下Storage::response()对$disposition参数的处理优先级问题。以下是两种可靠的解决方式：

方式1：明确设置Content-Disposition响应头 #

直接在headers数组中指定Content-Disposition为inline并关联文件名，确保浏览器明确识别为在线预览：

return Storage::disk('public')->response(
    $path,
    $responseFileName,
    [
        'Content-Type' => 'application/pdf',
        'Content-Disposition' => 'inline; filename="' . $responseFileName . '"'
    ]
);

方式2：使用response()->file()方法替代 #

Laravel的response()->file()方法对文件预览的响应头处理更直接，兼容性更好：

// 获取本地文件路径
$localFilePath = Storage::disk('public')->path($path);

return response()->file($localFilePath, [
    'Content-Type' => 'application/pdf',
    'Content-Disposition' => 'inline; filename="' . $responseFileName . '"'
]);

额外排查点 #

• 浏览器设置：部分浏览器默认会下载PDF，可在浏览器设置中调整为"在浏览器中打开PDF"
• 文件完整性：确认$path指向的PDF文件存在且未损坏，可直接访问文件URL测试
• 服务器配置：检查服务器（如Nginx/Apache）是否对PDF文件设置了强制下载的响应头

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