Laravel8如何结合数据库事务保证文件上传与记录保存的一致性 事务
Laravel 8头像上传需保证文件与数据库记录原子性，推荐五种策略：1.先写库后存文件并补偿删除；2.先存文件后写库并清理临时文件；3.临时目录+原子重命名；4.监听saved事件异步处理；5.事务后用afterCommit清理缓存。
在Laravel 8中执行用户头像上传并同步创建数据库记录时，若文件已存而数据库写入失败，或反之，就会产生孤立文件或空记录，必须让二者严格保持原子性。
先完成数据库写入，再保存文件并配补偿删除
该方法把数据库作为事务主体，文件操作放在事务提交之后，用逻辑控制模拟事务语义。适合对文件系统可靠性要求不高、且能接受少量补偿清理成本的场景。
1、调用 DB::transaction() 包裹模型创建操作，获取生成的主键ID；
2、显式调用 DB::commit() 提交事务；
3、使用该ID构造唯一路径，例如 Storage::putFileAs($request->file('avatar'), $id, 'avatars/' . $id . '.jpg')；
4、若文件保存失败，立即执行 DB::table('users')->where('id', $id)->delete() 清理残留记录——【这一步不可跳过，否则将留下无头像关联的脏数据】。
先保存文件，再写入数据库并绑定路径
此方式以文件系统为第一落点，规避了数据库事务无法回滚文件写入的问题。适用于上传服务独立部署、或需快速响应前端的业务流。
方法一：直接存储后插入
调用 $path = $request->file('avatar')->store('temp_uploads') 获取相对路径；
开启 DB::transaction()，在闭包内创建模型并赋值 $user->avatar_path = $path 后保存；
方法二：带校验的路径绑定
先检查 Storage::exists($path) 确认文件真实存在，再进入事务；
若事务失败，文件保留在 temp_uploads 目录中，需后续通过 Artisan 命令扫描并清理超过2小时的孤立文件。
使用临时目录 + 原子重命名策略
该方案依赖本地文件系统 rename 的原子性，在事务提交后才将临时文件移至正式位置，彻底避免中间态残留。仅适用于 storage 驱动为 local 且不跨磁盘挂载的环境。
第一步：生成 UUID 临时路径，如 $tempPath = storage_path('app/temp/' . Str::uuid() . '.tmp')；
第二步：调用 File::put($tempPath, file_get_contents($request->file('avatar')->getRealPath())) 写入；
第三步：开启事务，插入用户记录并获取 $id，但暂不提交；
第四步：事务成功后执行 rename($tempPath, storage_path('app/avatars/' . $id . '.jpg'))；若事务失败，手动调用 File::delete($tempPath)。
监听模型事件触发延迟文件写入
解耦文件操作与事务生命周期，利用 Eloquent saved 事件在模型持久化完成后异步处理文件，依赖队列保障最终一致性。适合高并发上传且允许秒级延迟的场景。
1、在 User 模型的 boot() 方法中注册：static::saved(fn ($user) => UploadAvatarJob::dispatch($user));
2、Job 类中判断 $user->wasRecentlyCreated === true，再读取原始上传文件（需提前将 $request->file() 存入缓存或 session）；
3、使用 Storage::putFileAs() 保存，并更新 $user->avatar_path 字段——注意此处不能再进事务，否则会嵌套失败；
4、若 Job 执行失败，队列自动重试，无需人工干预。
事务后主动删除缓存项（配合文件-记录联动）
当上传头像同时更新了用户缓存（如 Cache::put('user:123', $user)），必须确保缓存失效时机与数据库事务提交严格对齐，否则前端可能读到旧头像URL。
在 DB::transaction() 闭包外，用 DB::afterCommit() 封装缓存清理：
DB::afterCommit(function () use ($userId) { Cache::forget('user:' . $userId); });
这比 try-catch 中手动 forget 更可靠，因为 afterCommit 只在真正提交后触发，不会因事务内部异常或未提交而误删。
