Laravel多文件上传时如何避免相同文件名导致的程序崩溃

问题根源 #

程序崩溃核心原因是文件名生成逻辑存在高重复概率：

• 当前使用 date('mdYhis') 作为文件名前缀，时间精度仅到秒，同一秒内上传的多个原文件名相同的文件，生成的存储文件名完全一致
• 重复的文件名会导致本地文件写入时相互覆盖，同时数据库 updateOrCreate 操作会触发重复数据冲突，最终导致程序崩溃

修复步骤 #

1. 优化文件名生成逻辑（核心修复） #

使用「时间戳+随机字符串+原文件名」的组合规则保证文件名全局唯一，Laravel 自带的 Str::random() 方法可以快速生成安全的随机串：
首先在控制器头部引入Str类：

use Illuminate\Support\Str;

修改循环内的文件名生成代码：

// 原代码
// $image_name = date('mdYhis').'_'.$imageName[$key]; 

// 替换为
$image_name = date('mdYhis') . '_' . Str::random(8) . '_' . $imageName[$key];

如果需要更稳妥的完全去重方案，可以增加文件存在性判断逻辑：

$baseName = pathinfo($imageName[$key], PATHINFO_FILENAME);
$ext = pathinfo($imageName[$key], PATHINFO_EXTENSION);
$storagePath = public_path().'/app/default/files-module/local/images/';
$image_name = date('mdYhis') . '_' . $baseName . '.' . $ext;
$counter = 1;
// 循环判断文件是否存在，存在就追加序号
while (file_exists($storagePath . $image_name)) {
    $image_name = date('mdYhis') . '_' . $baseName . '_' . $counter . '.' . $ext;
    $counter++;
}

2. 补充异常捕获增强稳定性 #

用try-catch包裹文件写入和数据库操作逻辑，避免单文件出错导致整个请求崩溃，同时可以记录错误日志方便排查：

foreach ($image as $key => $value) {
    try {
        // 原有文件写入、数据库操作代码都放到这里
        $image_name = date('mdYhis') . '_' . Str::random(8) . '_' . $imageName[$key];
        $imgdata = base64_decode($value);
        $myOutput = public_path().'/app/default/files-module/local/images/'.$image_name;
        $ifp = fopen( $myOutput, 'wb' ); 
        fwrite( $ifp, $imgdata );
        fclose( $ifp );
        // 后续获取图片信息、数据库写入逻辑保持不变
        $imageInfo = getimagesize($myOutput);
        $files = FileModel::updateOrCreate(['name'=>$image_name],[
            'sort_order'=>0+$key,
            'created_at'=>date('Y-m-d H:i:s'),
            'updated_at'=>date('Y-m-d H:i:s'),
            'created_by_id'=>0,
            'disk_id'=>1,
            'folder_id'=>1,
            'extension'=>str_replace('image/', '', $imageInfo['mime']),
            'size'=>$imageInfo[0]*$imageInfo[1],
            'mime_type'=>$imageInfo['mime'],
            "entry_type" => "Anomaly\Streams\Platform\Model\Files\FilesImagesEntryModel",
            "height" => $imageInfo[1],
            "width" => $imageInfo[0],
        ]);
        DB::table('truckian_products_image')->insert(['entry_id'=>$p_id,'file_id'=>$files->id,'sort_order'=>$key+1]);
    } catch (\Exception $e) {
        // 记录错误日志，可根据业务需求选择跳过当前文件或终止操作
        \Log::error('文件上传失败:'.$e->getMessage(), ['file_name' => $imageName[$key]]);
        continue;
    }
}

3. 可选优化建议 #

• 给文件存储表的name字段增加唯一索引，从数据库层面避免重复数据插入
• 如果前端是直接提交表单没有做base64转换，需要把文件上传框的name属性改为files[]，否则后端只能收到最后一个文件
• 推荐使用Laravel自带的文件存储系统（Storage门面）处理文件上传，内置自动生成唯一文件名的功能，不需要手动处理重复问题

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