Laravel中response()->file()提示文件不存在但路径正确的问题求助

我编写了如下用于展示已上传PDF文件的Laravel函数：

public function readPDF($file_id)
{
    $file_id = SiteHelpers::encrypt_decrypt($file_id, 'd');
    $file_details = $this->model->getFileDetails($file_id);
    if($file_details){
        $file = Storage::url('app/public/course/'.$file_details->course_id.'/'.$file_details->file_name.'.'.$file_details->file_extension);
        print_r($file);
        header('Content-type: application/pdf');
        header('Content-Disposition: inline; filename=document.pdf');
        header('Content-Transfer-Encoding: binary');
        header('Accept-Ranges: bytes');
        // @readfile($file);
        return response()->file($file);
    }
}

移除无作用的@readfile($file);后，发现$file输出的路径能正常打开PDF，但return response()->file($file);提示文件不存在。

问题根源 #

Storage::url()返回的是前端可访问的Web URL（比如/storage/app/public/course/xxx/file.pdf），而response()->file()需要的是服务器本地的绝对文件路径（比如/var/www/html/storage/app/public/course/xxx/file.pdf），两者完全不是一个概念，这就是报错的核心原因。

修复步骤 #

1. 替换路径生成方式
   把Storage::url()换成Storage::path()，后者会返回服务器本地的真实文件路径：

   $file = Storage::path('public/course/'.$file_details->course_id.'/'.$file_details->file_name.'.'.$file_details->file_extension);
   

   注意：Storage::path()不需要加app/前缀，因为Laravel的public磁盘默认指向storage/app/public目录。

2. 验证文件是否真实存在
   在返回响应前，先确认文件确实存在，避免报错：

   use Illuminate\Support\Facades\File;
   
   if (!File::exists($file)) {
       abort(404, '文件不存在');
   }
   

3. 移除手动设置的响应头
   response()->file()会自动根据文件类型设置正确的Content-Type、Content-Disposition等响应头，手动添加的header可能会导致冲突，直接删掉即可。

修复后的完整代码 #

public function readPDF($file_id)
{
    $file_id = SiteHelpers::encrypt_decrypt($file_id, 'd');
    $file_details = $this->model->getFileDetails($file_id);
    
    if($file_details){
        // 生成服务器本地绝对路径
        $file = Storage::path('public/course/'.$file_details->course_id.'/'.$file_details->file_name.'.'.$file_details->file_extension);
        
        // 验证文件存在性
        if (!File::exists($file)) {
            abort(404, '文件不存在');
        }
        
        // 返回文件响应，可自定义显示文件名
        return response()->file($file, [
            'Content-Disposition' => 'inline; filename="'.$file_details->file_name.'.'.$file_details->file_extension.'"'
        ]);
    }
    
    // 未找到文件详情时返回404
    abort(404, '未找到文件信息');
}

额外说明 #

• 如果你想让浏览器显示原文件名而非默认的document.pdf，可以在response()->file()的第二个参数里自定义Content-Disposition。
• 确保已经执行过php artisan storage:link创建软链接（仅影响Web访问，本地路径读取不需要依赖软链接）。

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