Laravel图片上传异常：文件存为文件夹且访问404求助

DevOps 小满

2026-7-8

Laravel图片上传错误：图片被存为文件夹的解决方法

问题原因

你调用move()方法时参数使用错误：move($destinationPath, $name)的第一个参数是目标目录路径，第二个参数才是文件名。你现在把带文件名的完整路径传给第一个参数，Laravel会将这个路径识别为要创建的目录，最终生成了和文件名同名的空文件夹，图片根本没有被保存进去，自然访问时会提示资源不存在。

修正后的代码

public function uploadImage(Request $request)
{
    $request->validate([
        'photo' => 'required|image|mimes:jpeg,png,jpg,gif,svg|max:2048',
    ]);

    $photo = $request->file('photo');
    // 生成唯一文件名，避免同名文件覆盖
    $photoName = uniqid() . '.' . $photo->getClientOriginalExtension();
    // 目标目录：仅指定到storage文件夹，不带文件名
    $destinationDir = public_path('storage');
    // 正确调用move：第一个参数传目录，第二个传文件名
    $photo->move($destinationDir, $photoName);
    // 存储相对路径（不要存绝对路径，适配不同环境）
    $imagePath = 'storage/' . $photoName;

    $model = new Image();
    $model->image_path = $imagePath;
    $model->save();

    return response()->json([
        'message' => 'Image uploaded successfully!',
        'image_path' => $imagePath,
    ]);
}

额外注意事项

创建Storage软链接：Laravel标准做法是将上传文件存到storage/app/public目录，再通过软链接映射到public/storage，确保文件能被外部访问。如果还没创建软链接，运行以下命令：
```
php artisan storage:link
```
对应修改代码中的目录：
```
$destinationDir = storage_path('app/public');
$imagePath = 'storage/' . $photoName; // 访问路径不变
```
避免文件名冲突：使用uniqid()或Str::random()生成唯一文件名，防止后续上传的同名文件覆盖旧文件。
不要存储绝对路径：绝对路径在本地开发和生产服务器环境中不一致，存储相对路径更稳定，前端访问时拼接域名即可。