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

主机环境下Laravel存储目录链接失效,图片无法加载求助

解决Laravel无SSH权限下Storage链接失效问题

问题原因

共享主机通常限制PHP进程创建符号链接(软链接),即便Artisan::call('storage:link')返回成功提示,实际并未生成有效链接,导致asset('storage/...')无法访问storage目录下的文件。

可行解决方案

1. 修改文件系统配置(推荐)

直接将公开存储目录指向public下的物理文件夹,无需依赖软链接:

  • 打开config/filesystems.php,找到disks中的public配置,修改root参数:
'public' => [
    'driver' => 'local',
    'root' => public_path('storage'), // 改为public下的storage文件夹
    'url' => env('APP_URL').'/storage',
    'visibility' => 'public',
],
  • 通过FTP将本地storage/app/public中的文件上传到主机public/storage目录
  • 后续上传的文件会直接写入public/storage,asset('storage/cars/photo.jpg')可正常访问

2. 搭建图片代理路由

如果不想修改存储配置,可创建路由代理访问storage文件:

Route::get('storage/{path}', function ($path) {
    $filePath = storage_path('app/public/' . $path);
    if (!file_exists($filePath)) {
        abort(404);
    }
    return response()->file($filePath);
})->where('path', '.*');

访问图片时直接使用url('storage/cars/photo.jpg'),路由会读取storage/app/public下的文件并返回响应。

3. FTP手动创建软链接(部分主机支持)

若主机允许FTP创建符号链接,可通过FTP客户端操作:

  • 打开FTP客户端(如FileZilla),进入网站根目录的public文件夹
  • 右键空白处选择「创建链接」,目标路径填写../storage/app/public(需根据主机实际目录结构调整)
  • 确认链接创建后,asset('storage/...')即可正常访问

注意事项

  • 确保storage/app/public目录权限设置为755或主机要求的可访问权限
  • 用FTP检查public/storage是否为符号链接(而非普通文件夹),若为文件夹则说明软链接创建失败

内容的提问来源于stack exchange,提问作者Edel Rojas

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.16 10:10:25