Laravel 在本地开发时 Storage::disk('public') 正常工作，但部署到共享主机后头像上传失败，根本原因在于 storage/app/public 符号链接缺失或路径配置不兼容，需改用直接写入 public/ 目录并正确配置文件系统磁盘。
laravel 在本地开发时 `storage::disk('public')` 正常工作，但部署到共享主机后头像上传失败，根本原因在于 `storage/app/public` 符号链接缺失或路径配置不兼容，需改用直接写入 `public/` 目录并正确配置文件系统磁盘。
在共享主机环境中，Laravel 默认的 public 磁盘（基于 storage/app/public + 符号链接）往往无法正常工作——因为多数共享主机禁止执行 php artisan storage:link 命令，且不支持符号链接（symlink），导致 storage/app/public 目录不可写或 URL 访问 404。
✅ 正确做法是：绕过 storage 目录，直接将文件保存至 public/images/，并自定义一个指向该物理路径的磁盘配置。
步骤一：修改 config/filesystems.php
在 'disks' 数组中新增或替换 public_html（或 public_images）磁盘（避免与 Laravel 内置 public 磁盘冲突）：
'disks' => [
// ... 其他磁盘
'public_images' => [
'driver' => 'local',
'root' => public_path('images'), // 实际写入 public/images/
'url' => env('APP_URL', 'http://localhost') . '/images',
'visibility' => 'public',
],
],✅ 注意：
public_path('images')会解析为your-project/public/images，确保该目录存在且可写（可通过 FTP 创建，并设权限为755或775）。
步骤二：更新控制器上传逻辑
将原 storeAs('images', $unique_name, 'public') 替换为使用新磁盘，并手动处理文件保存与数据库更新：
use Illuminate\Support\Facades\Storage;
use Illuminate\Http\UploadedFile;
public function upload(Request $request)
{
$validatedData = $request->validate([
'image' => 'required|image|mimes:jpeg,png,jpg,gif,svg|max:2048',
]);
if ($request->hasFile('image')) {
/** @var UploadedFile $file */
$file = $request->file('image');
$extension = $file->getClientOriginalExtension();
$filename = md5($file->getClientOriginalName() . time()) . '.' . $extension;
// 使用自定义磁盘写入 public/images/
$path = $file->storeAs('images', $filename, 'public_images');
// ✅ 关键：$path 是相对路径（如 "images/abc123.png"），可直接存入数据库
Auth::user()->update(['image' => $filename]); // 或存 $path，视前端 img src 而定
}
return redirect('user/profile')->with('success', 'Profile image successfully changed!');
}步骤三：前端正确显示图片
在 Blade 模板中，使用 asset() 生成绝对 URL（因文件位于 public/ 下，无需 Storage::url()）：
<img src="{{ asset('images/' . Auth::user()- alt="Laravel 项目部署到共享主机后 Storage 存储失效的完整解决方案" >image) }}" alt="Avatar" width="100">⚠️ 不要使用
Storage::url()—— 它依赖storage:link，共享主机通常不支持。
补充注意事项
- ? 权限检查：通过 FTP 登录，确认
public/images/目录存在且权限为755；若上传仍失败，尝试临时设为777（上线前务必改回）。 - ? URL 配置：确保
.env中APP_URL设置正确（如https://yoursite.com），否则asset()生成的链接可能协议或域名错误。 - ? 清理旧逻辑：删除
storage/app/public/images/中残留文件，避免混淆；无需运行php artisan storage:link。 - ? 部署建议：将
public/images/视为静态资源目录，可随项目一同上传，无需额外同步。
通过以上配置，你完全规避了共享主机对符号链接和 storage 目录的限制，实现稳定、可追溯、零依赖的文件上传方案。
