跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

一致性模型

最后更新 查看 MarkdownAgent 设置

本页介绍 R2 的一致性模型,包括 R2 在哪些方面具有强全局一致性,以及哪些操作适用。

与其他分布式对象存储系统相比,R2 可以描述为"强一致"。这种强一致性确保对 R2 的操作能看到最新(准确)的状态:客户端应能立即、全局地观察到任何写入、更新和/或删除操作的效果。

术语

在 R2 的上下文中,强一致性和最终一致性具有以下含义:

  • 强一致 - 操作的效果将被全局、立即地被所有客户端观察到。客户端不会观察到"陈旧"(不一致)的状态。
  • 最终一致 - 客户端可能不会立即看到操作的效果。状态可能需要一些时间(通常为几秒到一分钟)才能全局传播。

操作与一致性

对 R2 存储桶和对象的操作遵循以下一致性保证:

Action Consistency
写后读:写入(上传)对象,然后读取 强一致:读取者将立即在全球范围看到最新对象
元数据:更新对象的元数据 强一致:读取者将立即在全球范围看到更新的元数据
删除:删除对象 强一致:对该对象的读取将立即返回"不存在"错误
对象列表:列出存储桶中的对象 强一致:列表操作将列出该时间点的所有对象
IAM:添加/移除 R2 Storage 权限 最终一致:新建或更新的 API 密钥 可能需要最多一分钟才能在全球范围反映权限

其他说明:

  • 如果两个客户端同时写入(PUT 或 DELETE)同一键,最后完成的写入者"获胜"。
  • 执行分片上传时,所有分片成功上传后,写后读一致性仍然适用。如果同一分片被多个写入者(错误地)上传,最后一次写入将获胜。
  • 在同一存储桶内复制对象也遵循与新对象写入相同的写后读一致性。复制操作完成后,所有客户端可以立即读取"复制的"对象。
  • 要删除 R2 存储桶,必须先完全清空才能删除。如果您尝试删除仍包含对象的存储桶,将收到如下错误:The bucket you tried to delete (X) is not empty (account Y) 或 Bucket X cannot be deleted because it isn't empty. 有关清空和删除存储桶的说明,请参阅删除存储桶。

条件写入

R2 会原子评估条件写入请求头(例如 PutObject 上的 If-Match 和 If-None-Match),并将其作为提交该对象的同一次写入的一部分:

  • 条件始终对照写入提交时存储桶的已提交状态进行评估,而不会对照更旧的快照。
  • 对同一键的竞争性条件写入会串行化。当两个或多个客户端对先前不存在的键并发发出带 If-None-Match: * 的 PutObject 时,最多只有一个请求成功,其余请求均以 412 PreconditionFailed 错误失败。因此可以安全地依赖 If-None-Match: * 实现“仅创建一次”语义:两次并发条件写入不可能都观察到成功。

S3 API 用法请参阅 PutObject 中的条件操作。

否定读取与进行中的写入

返回 NoSuchKey(404)的强一致读取(HeadObject 或 GetObject)表示在处理该读取时对象不存在。对于结果仍未知的更早 PutObject,这一缺失并非 最终结论:仍在传输中的请求——例如客户端在收到响应前丢失连接——可能在否定读取返回之后才提交。读取从不陈旧,但它们不会等待或取消更早的写入。

若需要将否定读取视为写入失败的证明,请先确保原始写入已明确完成(成功或返回明确错误),然后再信任该读取。也可以使用 If-None-Match: * 重试写入:如果那次结果不明的写入实际上已提交,它会以 412 PreconditionFailed 失败。

缓存

当将自定义域名连接到 R2 存储桶并为从该存储桶提供的对象启用缓存时,通过启用了缓存的域名访问内容时,一致性模型必然有所放宽。

具体而言,您应预期:

  • 您从 R2 删除但仍在缓存中的对象仍然可用。如果需要反映删除操作,您应清除缓存。
  • 默认情况下,Cloudflare 的缓存会自动缓存 HTTP 404(Not Found)响应。如果您向同一路径上传对象,缓存可能继续返回 HTTP 404,直到缓存 TTL(Time to Live)过期并从 R2 获取新对象,或清除缓存。
  • 给定键的对象被新对象覆盖:旧(先前)对象将继续提供给客户端,直到缓存 TTL 过期(或对象被逐出),或清除缓存。

缓存不影响通过 Worker API 绑定 或 S3 API 的访问,因为这些操作直接针对存储桶进行,不经过缓存。

这篇文档对您有帮助吗?