Laravel项目图片上传成功但视图无法显示问题排查求助

你的问题核心在于Local磁盘的私有配置与Web服务器访问权限不匹配：

1. 你的local磁盘配置中visibility为private，存储根目录是storage/app/private，这个目录属于Laravel的私有存储区，Web服务器默认无法直接访问（Web服务器仅对外开放public目录）。
2. Storage::url()生成的/storage/xxx链接，对应的是Laravel默认public磁盘的软链路径（即storage/app/public通过php artisan storage:link映射到public/storage），但你的图片实际存在storage/app/private，所以前端请求的路径根本没有对应文件。
3. 私有存储的权限设置（目录0700、文件0600）也限制了Web服务器进程读取文件，即使路径正确也无法访问。

当你切换到public磁盘后，图片会存在storage/app/public，且该目录通过软链暴露给Web服务器，同时权限为公开可读取，所以图片能正常显示。

根据你的需求选择对应方案：

方案1：需要图片公开访问（推荐，和你切换public磁盘的逻辑一致） #

1. 保持使用public磁盘存储图片，确保已经执行过软链命令：

   php artisan storage:link
   

   这个命令会在public/storage和storage/app/public之间创建软链，让Web服务器能访问到存储的文件。
2. 如果你想继续用local磁盘但实现公开访问，可以修改filesystems.php中的local配置：

   'local' => [
       'driver' => 'local',
       'root' => storage_path('app/public'), // 改为public存储目录
       'visibility' => 'public', // 改为公开可见性
   ],
   

   本质上这和默认的public磁盘配置一致。

方案2：需要图片私有访问（仅授权用户可见） #

如果图片不能公开，必须通过权限验证才能访问，不要直接暴露URL，而是通过控制器代理访问：

1. 添加控制器方法处理图片请求：

   public function showServiceImage($imagePath)
   {
       // 1. 验证用户权限：比如检查当前用户是否是对应商家
       $service = Service::where('feature_image', $imagePath)->firstOrFail();
       if (auth()->user()->merchant_id !== $service->merchant_id) {
           abort(403, '无访问权限');
       }
   
       // 2. 读取图片并返回响应
       $disk = Storage::disk('local');
       if (!$disk->exists($imagePath)) {
           abort(404);
       }
   
       $fileContent = $disk->get($imagePath);
       $mimeType = $disk->mimeType($imagePath);
   
       return response($fileContent)->header('Content-Type', $mimeType);
   }
   

2. 添加路由：

   Route::get('service-images/{imagePath}', [ServiceController::class, 'showServiceImage'])->name('service.image');
   

3. 修改视图中的图片链接：

   <td>
       <img src="{{ route('service.image', $service->feature_image) }}" style="max-width:300px !important; max-height:100px !important; border-radius:none !important;" />
   </td>
   

4. 注意：此时index()方法中不要调用Storage::url()，直接使用数据库中存储的原始路径即可。

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