Laravel Storage部署至虚拟主机后失效：头像上传功能异常求助

你提供的代码逻辑本身没有问题，失效原因大概率出在虚拟主机的环境配置上，以下是几个必查修复点：

1. 检查Storage软链接是否创建 #

Laravel的public磁盘默认将文件存在storage/app/public目录，通过public/storage软链对外提供访问。虚拟主机环境下可能未执行创建软链的命令：

php artisan storage:link

如果虚拟主机不允许执行artisan命令，可手动修改config/filesystems.php里的public磁盘配置，直接将文件存储到public/images目录（需先在public下创建images文件夹）：

'public' => [
    'driver' => 'local',
    'root' => public_path('images'),
    'url' => env('APP_URL').'/images',
    'visibility' => 'public',
],

2. 目录权限设置 #

虚拟主机上，storage/app/public或public/images（如果修改了存储路径）的目录权限必须让服务器拥有写入权限：

• 目录权限设为755，文件权限设为644
• 确保目录所有者为服务器运行用户（如www-data、apache），可通过虚拟主机面板的文件管理功能直接修改权限

3. PHP上传限制检查 #

你的代码限制文件最大2MB，虚拟主机的PHP配置可能存在更小的限制：

• 检查upload_max_filesize和post_max_size参数是否≥2M
• 若虚拟主机支持自定义php.ini，直接修改这两个参数；若为面板管理，在PHP设置模块调整上传限制

4. 确认表单enctype属性 #

虽然本地正常，仍需确认前端表单是否添加了enctype="multipart/form-data"，缺少该属性文件无法正常上传：

<form method="POST" action="/upload" enctype="multipart/form-data">
    <!-- 表单内容 -->
</form>

5. 验证文件存储状态 #

可在代码中添加日志，确认文件是否真的上传到服务器：

// 在storeAs之后添加日志
\Log::info('Image stored path: '.storage_path('app/public/images/'.$unique_name));

查看虚拟主机上的Laravel日志（storage/logs/laravel.log），确认文件路径是否存在、有无写入错误提示

6. 增加认证状态判断 #

虚拟主机环境下可能存在认证状态丢失的极端情况，可添加判断避免报错：

if(Auth::check()){
    Auth()->user()->update(['image'=>$unique_name]);
} else {
    return Redirect('user/profile')->with("error","认证失败，无法更新头像");
}

按照上述步骤逐一排查，基本可以解决虚拟主机上的头像上传失效问题。

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