Laravel 9图片上传异常：数据库存记录但存储文件夹无文件

Laravel 9 图片上传问题修复指南 #

1. 检查存储目录的存在性与权限 #

首先确认storage/app/public/images目录是否存在，不存在则手动创建：

mkdir -p storage/app/public/images

给目录设置正确权限（Linux/macOS环境，本地开发可替换为自己的系统用户名）：

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

2. 修正控制器核心问题 #

你的控制器代码存在两个关键问题：未将上传文件名存入数据库、原文件名易重复导致覆盖。修改后的代码如下：

public function store(Request $request) {
    $request->validate([
        'name' => 'required',
        'slug' => 'required',
        'description' => 'required',
        'meta_title',
        'meta_description',
        'meta_keywords',
        'image' => 'image|mimes:jpeg,png,jpg,gif|max:2048' // 新增图片格式验证
    ]);

    $data = $request->all();

    if($request->hasFile('image')){
        // 加时间戳避免文件名重复
        $filename = time() . '_' . $request->image->getClientOriginalName();
        // 执行图片存储
        $request->image->storeAs('images', $filename, 'public');
        // 将文件名存入数据数组，确保写入数据库
        $data['image'] = $filename;
    }

    Category::create($data);

    return redirect()->route('category.index')->with('success', 'Category was added successfully !');
}

注意：原方法中的Category $category参数属于多余的路由模型绑定，直接删除即可。

3. 重新确认软链接有效性 #

即便执行过storage:link，也可能出现软链接失效的情况，重新执行一次：

php artisan storage:link

如果提示软链接已存在，先删除旧链接再重建：

rm public/storage
php artisan storage:link

4. 修复视图循环变量冲突 #

视图中@foreach($category as $category)会覆盖原有变量，导致逻辑异常，修改为：

@foreach($categories as $category) {{-- $categories对应控制器传递的分类列表变量名 --}}
    <tr>
        <th>{{$category->id}}</th>
        <td>{{$category->name}}</td>
        <td>{{$category->slug}}</td>
        <td>{{$category->description}}</td>
        <td>{{$category->status}}</td>
        <td>{{$category->popular}}</td>
        <td>
            {{-- 判断图片是否存在，避免显示破图 --}}
            @if($category->image)
                <img class="rounded-circle mt-4" src="{{asset('storage/images/'.$category->image)}}" style="width: 50px;height: 50px;">
            @else
                <span>No Image</span>
            @endif
        </td>
        <td>{{$category->meta_title}}</td>
        <td>{{$category->meta_description}}</td>
        <td>{{$category->meta_keywords}}</td>
        <td>
            <form action="{{ route('category.destroy', $category->id)}}" method="POST">
                <a href="{{ route('category.edit',$category->id)}}" class="btn btn-primary float-end me-2">Edit</a>
                @csrf
                @method('DELETE')
                <button class="btn btn-danger float-end" type="submit">Delete</button>
            </form>
        </td>
    </tr>
@endforeach

5. 调试存储异常 #

如果仍无法存储图片，可添加调试代码定位错误：

try {
    $request->image->storeAs('images', $filename, 'public');
    dd('存储成功，文件路径：', storage_path('app/public/images/'.$filename));
} catch (\Exception $e) {
    dd('存储失败，错误信息：', $e->getMessage());
}

内容的提问来源于stack exchange，提问作者rayen grid