You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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) }}"/>
    
  • 检查目录权限
    服务器环境下执行以下命令设置目录权限:
    sudo chmod -R 755 storage
    sudo chmod -R 755 bootstrap/cache
    
    同时确认web运行用户(如www-data、nginx)为storage目录的所有者,避免权限不足导致无法读取文件。
  • 排查服务配置与缓存问题
    直接在浏览器地址栏输入完整图片路径测试访问,返回404则说明路径匹配错误,返回403则为权限问题。若配置修改后不生效,执行php artisan config:clear、php artisan cache:clear清除配置缓存与应用缓存。最后确认web服务器(Nginx/Apache)的站点根目录已指向项目的public文件夹,且无额外规则拦截storage路径下的静态资源。

内容的提问来源于stack exchange,提问作者pak Anyas

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.02 09:36:05