Laravel如何正确显示存储在storage/app/public下的PDF文件

1. 核心错误原因 #

response()->file() 要求传入服务器本地文件的物理绝对路径，你代码中传入的asset()函数生成的是对外可访问的HTTP链接（格式为http://localhost/xxx），不属于本地路径，因此框架无法定位到文件抛出错误。
你直接访问localhost/storage/xxx能正常打开，是因为你已经执行过php artisan storage:link命令，把storage/app/public目录软链接到了项目根目录的public/storage下，这个访问走的是静态资源解析，和PHP路由返回文件的逻辑完全不同。

2. 正确的showFile方法写法 #

你可以用Laravel提供的storage_path辅助函数生成正确的本地路径，路径统一用正斜杠即可，Laravel会自动适配Windows和Linux系统的路径分隔符，不需要手动写反斜杠：

public function showFile()
{
    // storage_path('app/public') 对应storage下公开目录的物理路径
    $filePath = storage_path('app/public/uploads/clients/1/2/test.pdf');
    return response()->file($filePath); 
}

3. 额外优化建议 #

• 存储文件的时候建议用Laravel自带的Storage门面，不要手动写file_put_contents，可自动处理路径适配、权限等问题：

// 保存文件到storage/app/public/uploads/clients/1/2目录下
Storage::disk('public')->putFileAs('uploads/clients/1/2', $request->file, $filename);

• 如果需要返回文件的下载响应而非直接在浏览器打开，可以用response()->download($filePath)方法。
• 如果需要判断文件是否存在，可以先调用Storage::disk('public')->exists('uploads/clients/1/2/test.pdf')做校验，避免抛出异常。

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