Laravel中Storage存储文件与数据库文件名不一致的解决方法

问题原因 #

当前代码中调用Storage::disk('public')->put('images', $image)时，仅指定了存储目录与上传文件实例，未传入自定义文件名参数，Laravel会默认生成随机唯一字符串作为文件名写入磁盘。而数据库中存入的是通过getClientOriginalName()获取的上传原始文件名，二者来源不同，自然无法匹配。

可用修复方案 #

方案1：指定使用原始文件名存储 #

如果业务需要保留用户上传的原始文件名，调用putFileAs方法手动指定存储文件名即可，该方法不会自动生成随机文件名：

if($request->hasFile('file')) {
    $image = $request->file('file');
    $imageName = $image->getClientOriginalName();
    // 手动指定存储文件名为原始文件名
    Storage::disk('public')->putFileAs('images', $image, $imageName);

    Post::create([
        'title' => $request->input('title'),
        'content' => $request->input('content'),
        'user_id' => Auth::id(),
        'file' => $imageName,
    ]);
}

风险提示：同目录下存在同名文件时，该方式会直接覆盖旧文件，不适合用户上传量大、无法保证文件名唯一的场景。

方案2：使用Laravel自动生成的唯一文件名（推荐） #

如果不需要强制保留原始文件名，优先使用该方案，可完全避免重名覆盖问题。putFile方法处理上传文件后会返回实际存储的相对路径（含自动生成的文件名），直接将该返回值存入数据库即可保证两边完全一致：

if($request->hasFile('file')) {
    $image = $request->file('file');
    // 自动生成唯一文件名存储，返回存储的相对路径
    $savedFilePath = Storage::disk('public')->putFile('images', $image);

    Post::create([
        'title' => $request->input('title'),
        'content' => $request->input('content'),
        'user_id' => Auth::id(),
        'file' => $savedFilePath,
    ]);
}

如果需要同时保留原始文件名用于前端展示，可以在posts表新增original_name字段，将$image->getClientOriginalName()的值存入该字段，实际文件读取仍使用自动生成的路径即可。

内容的提问来源于stack exchange，提问作者Osama Mohammed