面向中文开发者的 AWS 实战知识库 代维服务
上云咨询

如何在 S3 中恢复已删除的对象(先别慌)

导出 PDF 浅色排版、带版权水印,可在打印窗口另存为 PDF
如何在 S3 中恢复已删除的对象(先别慌)

简要说明(TL;DR)

  • 在启用了版本控制的存储桶上,直接执行 aws s3 rm 会写入一个删除标记(delete marker),而不是销毁数据字节。删除该标记的 VersionId 后,对象在不到一秒内即可恢复为可用状态。
  • 如果 get-bucket-versioning 返回 {} 或 {"Status": "Suspended"},那就没有标记可删,也没有先前的版本可复制。此时恢复完全依赖于复制(replication)、AWS Backup 或原始源文件。
  • 在我处理过的几乎所有"整个前缀都丢了"的事故中,根源都能追溯到某条生命周期规则在 1–7 天后使非当前版本过期,而不是有人手动敲了 rm。

S3 中的 DELETE 是一次写入,而非解链接

在文件系统上,rm 会释放数据块。在启用了版本控制的 S3 中,不带 versionId 的 DELETE 会插入一个新的零字节对象,其唯一属性就是"此键已删除"。先前的字节仍然存在、仍在计费,只要你知道版本 ID 就能读取。

混乱之所以产生,是因为所有正常的读取路径都会把这一点隐藏起来。GET 返回 NoSuchKey,HEAD 返回 404,控制台在该前缀下什么都不显示:

$ aws s3api head-object --bucket acme-assets-prod --key static/app.js --region us-east-1
An error occurred (404) when calling the HeadObject operation: Not Found


加上版本 ID,同一个调用就会成功:

```bash
$ aws s3api head-object --bucket acme-assets-prod --key static/app.js 
    --version-id 3HL4kqtJlcpXroDTDmJ.rmSpXd3dIbrHY --region us-east-1
{
    "AcceptRanges": "bytes",
    "ContentLength": 184320,
    "LastModified": "2026-02-03T09:12:44+00:00",
    "ETag": ""9b2cf535f27731c974343645a3985328"",
    "VersionId": "3HL4kqtJlcpXroDTDmJ.rmSpXd3dIbrHY"
}


在动手之前,有两件事必须内化于心:那个 404 是假的;而你想要的对象可能位于删除标记的*后面*,而不是位于*最新版本*。这两者是不同的修复路径。

## 把删除变成数据丢失的五种配置错误

| 错误 | 症状 | 原因 | 预防措施 |
|---|---|---|---|
| 从未启用版本控制 | `get-bucket-versioning` → `{}` | 存储桶由手动创建或由旧模板创建 | 在 Terraform/CDK 中创建时开启版本控制,并在 CI 中断言 |
| 版本控制处于**挂起(Suspended)**状态 | `{"Status": "Suspended"}`;新的 PUT 都使用 `versionId: null` | 有人为了停止为版本付费而"清理"了一下 | 永远不要挂起——改用生命周期过期 |
| `NoncurrentVersionExpiration: NoncurrentDays: 1` | 旧版本在被替换后 24 小时就消失 | 保留期短于你的恢复 SLA | 至少 30–90 天;把这份 JSON 当作生产代码对待 |
| IAM 授予了 `s3:DeleteObject` 但未授予 `s3:DeleteObjectVersion` | 恢复时报 `AccessDenied` 失败 | 策略只按常见场景编写 | 两个都授予,并限定到具体前缀 |
| MFA Delete 或 Object Lock 保留策略 | 即使拥有完整管理员权限也返回 403 | 合规控制,按设计正常工作 | 记录谁持有 MFA 设备以及保留窗口 |

挂起(Suspended)这种情况最难缠,因为它看起来是安全的。处于 `Suspended` 状态的存储桶会保留旧版本,但每次新的 `PUT` 都会写入字面版本 ID `null`,并就地覆盖先前的 null 版本。最终你得到的是一个"有版本控制"却仍然会悄悄丢失你刚编辑的文件所在的存储桶。

## 按正确顺序恢复单个对象

自上而下操作,不要跳过第 1 步。靠猜测版本控制状态,正是人们删错东西的原因。

```bash
# 1. 确认版本控制处于 Enabled(而非 Suspended)
aws s3api get-bucket-versioning --bucket acme-assets-prod --region us-east-1

# 2. 找到覆盖在该键之上的删除标记
aws s3api list-object-versions 
  --bucket acme-assets-prod 
  --prefix "static/app.js" 
  --query 'DeleteMarkers[?IsLatest==`true`].[VersionId,LastModified]' 
  --output text 
  --region us-east-1

# 3. 删除该标记——这才是真正的恢复操作
aws s3api delete-object 
  --bucket acme-assets-prod 
  --key "static/app.js" 
  --version-id "3HL4kqtJlcpXroDTDmJ.rmSpXd3dIbrHY" 
  --region us-east-1

# 4. 验证
aws s3api head-object --bucket acme-assets-prod --key "static/app.js" --region us-east-1


第 3 步看起来像一条破坏性命令,它确实就是——你删除的是墓碑(tombstone),而非数据。如果该标记不是 `IsLatest`,说明自删除以来又有内容写入到其上,你需要考虑哪个版本应当胜出。

有时你并不想"取消删除",而是想回滚到某个特定的旧版本并保持历史记录不变。这时应将该版本向前复制,而不是删除任何东西:

```bash
aws s3api copy-object 
  --bucket acme-assets-prod 
  --key "static/app.js" 
  --copy-source "acme-assets-prod/static/app.js?versionId=3HL4kqtJlcpXroDTDmJ%2BrmSpXd3dIbrHY" 
  --region us-east-1


注意那个 `%2B`。版本 ID 是包含 `+`、`/` 和 `=` 的不透明字符串,而在 `--copy-source` 内部它们会被当作查询字符串解析。未编码的 `+` 在传输中会变成空格,调用会以 `InvalidArgument`/`NoSuchVersion` 错误失败,而那个错误看起来完全不像是编码问题。我第一次就为此浪费了二十分钟。

## 前缀消失时进行批量恢复

对于几百个键,用循环就够了。CLI 会自动对 `list-object-versions` 分页,每页 1,000 个键,所以你不必自己处理 `NextKeyMarker`:

```bash
aws s3api list-object-versions 
  --bucket acme-assets-prod 
  --prefix "static/" 
  --query 'DeleteMarkers[?IsLatest==`true`].[Key,VersionId]' 
  --output text 
  --region us-east-1 |
while read -r key vid; do
  aws s3api delete-object --bucket acme-assets-prod --key "$key" --version-id "$vid"
done


超过约 5,000 个对象后,就不要再循环了,改用 `delete-objects`,它每次调用最多接受 1,000 个条目:

```bash
aws s3api delete-objects --bucket acme-assets-prod --region us-east-1 
  --delete file://markers.json


其中 `markers.json` 的格式为 `{"Objects": [{"Key": "static/app.js", "VersionId": "..."}]}`。超过 10 万个对象时,从 S3 Inventory 生成清单并交给 S3 Batch Operations——它会重试、逐对象报告状态,而且不会因为你的笔记本进入睡眠而中途挂掉。

顺便说一句,吞吐量并不是瓶颈。S3 每个前缀每秒能处理 3,500 个 DELETE/PUT 请求。瓶颈是你的终端。

## 何时不要使用此法

删除标记移除只有在版本仍然存在且你能控制该存储桶时才有用。在三种情况下它是错误的工具。

如果凭证泄露,攻击者拥有与你相同的权限,他们会带着明确的版本 ID 运行 `delete-objects`,或者先删除存储桶策略。合规模式下的 Object Lock 以及跨账户复制(目标由另一个账户拥有)是仅有的能在这种情况下幸存的控件。

如果删除是法律或 GDPR 的擦除请求,那么恢复才是违规行为,而不是修复手段。在动任何东西之前先检查是否存在法律保留(legal hold)。

而如果 `get-bucket-versioning` 显示在该对象的整个生命周期内版本控制都是关闭的,那就别再写脚本了。没有任何东西可以恢复——去找构建产物、上游系统或最近的备份,并接受可能有好几个小时的工作成果已经丢失。

## 故障排查:我无法移除的那个删除标记

2025-11-14,02:41 UTC。告警触发,因为某个生产站点上的静态资源前缀开始返回 404。存储桶显然启用了版本控制,标记也清楚地列了出来,但删除命令失败了:

```bash
An error occurred (AccessDenied) when calling the DeleteObject operation: Access Denied


第一反应是用了错误的 profile。`aws sts get-caller-identity` 返回的是预期的部署角色,所以身份并不是问题所在。然后我把附加到该角色的策略导出来,仔细阅读:它在 `arn:aws:s3:::acme-assets-prod/static/*` 上授予了 `s3:DeleteObject`。该操作涵盖普通的删除。移除删除标记是一次*带版本*的删除,需要 `s3:DeleteObjectVersion`,而这一权限完全缺失。

我用策略模拟器确认了这个推断,而不是靠猜测:

```bash
aws iam simulate-principal-policy 
  --policy-source-arn arn:aws:iam::123456789012:role/deploy-role 
  --action-names s3:DeleteObjectVersion 
  --resource-arns arn:aws:s3:::acme-assets-prod/static/app.js


结果返回 `implicitDeny`。添加该操作、重新运行删除、再重新运行 `head-object`,返回了 HTTP 200,原始 `ContentLength` 为 184320。总中断时间:约 25 分钟。

后续处理比修复本身更重要。在阅读存储桶配置时,我发现了一条三周前创建的生命周期规则,其中 `NoncurrentVersionExpiration: NoncurrentDays: 1`。如果这次事故晚发生一天,我恢复的那个版本就会永久消失。现在我在处理任何 S3 恢复工单时,第一件事就是阅读生命周期 JSON,然后才看 IAM。

## 验证:妥善收尾工单

`head-object` 返回 200 是必要的,但并不充分。确认 `list-object-versions` 不再显示该键存在 `IsLatest` 的删除标记,并将 ETag 与你的构建清单进行比对——恢复出错误的提交仍然是一次事故。

然后检查 CDN。CloudFront 会按 `ErrorCachingMinTTL` 缓存 404,而且很多配置会把它提高到 300 秒甚至更多。此时对象已经回到 S3,而用户仍然看到错误页面:

```bash
aws cloudfront create-invalidation 
  --distribution-id E1EXAMPLE123456 
  --paths "/static/app.js"


最后一项检查:导致这次事故的生命周期规则还在吗?如果在,你就已经为续集排好了档期。

我们在 awsgood.com 的托管服务中,为中小企业的存储桶执行这种生命周期与版本控制审计,通常花二十分钟读 JSON,就能避免一通凌晨三点的电话。

## 资料来源

- [从启用了版本控制的存储桶中删除对象版本](https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeleteMarker.html)
- [使用 S3 版本控制保留对象的多个版本](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Versioning.html)
- [使用生命周期规则使非当前对象版本过期](https://docs.aws.amazon.com/AmazonS3/latest/userguide/lifecycle-configuration-examples.html)
- [delete-object —— AWS CLI 命令参考](https://docs.aws.amazon.com/cli/latest/reference/s3api/delete-object.html)

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注