Uploadthing 项目中实现上传图片的回滚机制

在文件上传服务中，处理上传成功但后续操作失败的情况是一个常见需求。Uploadthing 作为一个文件上传服务，提供了完善的API来处理这类场景。

问题背景

在开发过程中，我们经常会遇到这样的流程：

1. 首先上传图片到文件存储服务
2. 然后将图片的元数据和其他文本内容保存到数据库

这个流程存在一个潜在问题：图片上传可能成功，但数据库操作可能失败。这种情况下，已经上传的图片实际上永远不会被访问，因为它没有对应的元数据记录。

Uploadthing 的解决方案

Uploadthing 提供了 UTApi 的 deleteFiles 方法来解决这个问题。这个方法允许开发者在后续操作失败时，删除已经上传的文件，实现事务的回滚。

实现示例

以下是典型的实现模式：

// 尝试上传图片
const uploadImage = await startUpload([image!]);

try {
  // 尝试保存元数据到数据库
  await myDb.create({image: uploadImage[0].url});
} catch (err) {
  // 如果数据库操作失败，删除已上传的图片
  await utapi.deleteFiles(uploadImage[0].key);
  throw err; // 重新抛出错误
}

最佳实践

1. 错误处理：始终使用 try-catch 块来处理可能失败的操作
2. 事务完整性：确保在任何一个步骤失败时，系统能恢复到一致状态
3. 资源清理：及时清理不再需要的资源，避免存储空间浪费

技术要点

• deleteFiles 方法接受文件key作为参数
• 该方法可以删除单个或多个文件
• 删除操作是永久性的，不可恢复

通过这种机制，开发者可以构建更健壮的上传流程，确保系统在各种异常情况下都能保持一致状态。