Laravel部署后图片存储路径异常，无法显示问题求助

核心问题定位 #

你的代码中$this->image->store('users')未指定存储磁盘，会使用Laravel默认配置的文件系统磁盘。本地环境默认磁盘大概率是public，但线上环境的默认磁盘可能被设为local，导致文件被存到storage/app/users而非storage/app/public/users，自然无法通过软链接访问。

具体解决步骤 #

1. 确认默认磁盘配置 #

检查线上环境的.env文件，确保设置正确的默认磁盘：

FILESYSTEM_DISK=public

如果缺少该配置，Laravel默认会使用local磁盘，而local磁盘的根目录是storage/app，这就是文件存错路径的直接原因。

2. 显式指定存储磁盘（更稳妥的写法） #

即使默认磁盘配置正确，也建议在存储时显式指定public磁盘，避免环境差异引发问题：

// 替换原store方法调用，添加第二个参数指定磁盘
$data["image"] = str_replace('public/', '', $this->image->store('users', 'public'));

这样无论默认磁盘是什么，都会强制使用public磁盘存储，确保文件进入storage/app/public/users目录。

3. 验证软链接有效性 #

• 执行软链接创建命令：

php artisan storage:link

• 若线上是共享主机无shell权限，可临时通过代码创建软链接（在routes/web.php添加以下路由，访问一次即可）：

Route::get('/create-storage-link', function () {
    $target = storage_path('app/public');
    $link = public_path('storage');
    if (!file_exists($link)) {
        symlink($target, $link);
        return 'Storage link created successfully.';
    }
    return 'Storage link already exists.';
});

4. 清除配置缓存 #

如果线上执行过php artisan config:cache，修改配置后需清除缓存：

php artisan config:clear

否则旧配置会持续生效。

额外验证点 #

检查线上服务器storage/app/public/users目录权限，确保web服务器用户（如www-data）拥有读写权限：

chown -R www-data:www-data storage/app/public
chmod -R 755 storage/app/public

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