Laravel 10图片存储异常：数据库存路径但文件未写入public指定目录

架构老林

2026-7-30

问题解决：Laravel图片未存入public指定路径

你的问题出在Laravel默认的文件存储逻辑上：storeAs()方法默认使用local磁盘，文件会被存在storage/app/uploads/category目录下，而非你预期的public/uploads/category，但数据库里的路径记录是正确的，只是实际文件位置不对。

下面是两种可行的解决方案：

方案一：使用public磁盘+软链接（Laravel推荐方式）

修改storeAs()调用，指定存储磁盘为public：

if ($request->hasFile('image')) {
    $file = $request->file('image');
    $extension = $file->getClientOriginalExtension();
    $filename = time().'.'.$extension;
    // 第三个参数指定使用public磁盘
    $path = $file->storeAs('uploads/category', $filename, 'public');
    $category->image = $path;
}

执行Artisan命令创建软链接，将storage/app/public目录映射到public/storage，这样web就能访问存储的文件：

php artisan storage:link

之后访问图片时，需要用asset('storage/' . $category->image)生成正确的URL。

方案二：直接将文件存入public目录

如果不想用软链接，可以直接把文件移动到public目录下，替换storeAs()为move()：

if ($request->hasFile('image')) {
    $file = $request->file('image');
    $extension = $file->getClientOriginalExtension();
    $filename = time().'.'.$extension;
    $targetDir = public_path('uploads/category');
    
    // 确保目标目录存在并有权限
    if (!File::exists($targetDir)) {
        File::makeDirectory($targetDir, 0755, true);
    }
    
    $file->move($targetDir, $filename);
    $category->image = 'uploads/category/' . $filename;
}

注意：需要引入Illuminate\Support\Facades\File类。这种方式下，访问图片直接用asset($category->image)即可。