Laravel上传图片存储正常但无法显示,尝试网上解决方案仍无效
Laravel 上传图片存储正常但无法展示解决方案
- 检查存储软链接配置
首先确认已执行Laravel官方存储链接命令:php artisan storage:link,如果此前执行过但无效,先删除public目录下已存在的storage文件夹,再重新执行命令。Windows环境下需用管理员权限运行终端创建软链接,服务器环境需确认web运行用户拥有软链接创建权限。 - 核对文件系统配置
打开config/filesystems.php文件,确认public磁盘配置如下:
同时检查'public' => [ 'driver' => 'local', 'root' => storage_path('app/public'), 'url' => env('APP_URL').'/storage', 'visibility' => 'public', ],.env文件中的APP_URL参数与你实际访问项目的域名/地址完全一致,避免资源路径拼接错误。 - 确认上传存储逻辑正确性
检查上传代码是否指定了public磁盘存储,正确写法示例:
未指定第二个参数$path = $request->file('profile_image')->store('profile_images', 'public');public的话,文件会默认存储到非公开的local磁盘,外部无法访问。同时确认数据库中profile_image字段仅存储文件名(如abc.jpg),未携带多余路径前缀。 - 修正视图资源引用写法
不要硬编码路径前缀,改用Laravel自带的asset辅助函数生成完整资源路径,示例:<img class="img img-fluid img-thumbnail" src="{{ asset('storage/profile_images/'.$profile->profile_image) }}"/> - 检查目录权限
服务器环境下执行以下命令设置目录权限:
同时确认web运行用户(如www-data、nginx)为storage目录的所有者,避免权限不足导致无法读取文件。sudo chmod -R 755 storage sudo chmod -R 755 bootstrap/cache - 排查服务配置与缓存问题
直接在浏览器地址栏输入完整图片路径测试访问,返回404则说明路径匹配错误,返回403则为权限问题。若配置修改后不生效,执行php artisan config:clear、php artisan cache:clear清除配置缓存与应用缓存。最后确认web服务器(Nginx/Apache)的站点根目录已指向项目的public文件夹,且无额外规则拦截storage路径下的静态资源。
内容的提问来源于stack exchange,提问作者pak Anyas
相关产品推荐
相关产品推荐

