www.awsgood.com
aws s3 rm 会写入一个删除标记(delete marker),而不是销毁数据字节。删除该标记的 VersionId 后,对象在不到一秒内即可恢复为可用状态。get-bucket-versioning 返回 {} 或 {"Status": "Suspended"},那就没有标记可删,也没有先前的版本可复制。此时恢复完全依赖于复制(replication)、AWS Backup 或原始源文件。rm。在文件系统上,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)