如何模拟AWS响应错误 验证S3批量删除对象的异常处理逻辑

核心执行逻辑 #

S3的批量删除接口不是全请求原子操作，执行规则非常明确：

• 只有请求本身未通过全局校验时，才会直接终止、不执行任何删除操作，同时SDK会抛出顶层异常。这类场景包括：身份无桶级删除权限、桶不存在、请求格式非法、单次传入对象数超过1000个的上限、开启MFA Delete但未携带合法MFA令牌等。
• 一旦请求通过全局校验进入对象处理阶段，S3会独立处理请求中的每一个对象key，不会因为单个/部分对象删除失败就中途终止整个请求，会等所有对象处理完成后再统一返回结果。
• 不存在“已标记待删除的对象会后台静默删除/不返回结果”的中间状态：每个对象的处理结果要么出现在成功列表，要么出现在失败列表，不会出现状态未知的情况。

SDK返回值与业务DTO映射 #

你不需要额外捕获单对象删除的异常，SDK v1对返回的封装逻辑和你定义的响应结构完全对齐：

• 若调用deleteObjects时直接抛出AmazonS3Exception，属于全局错误，本次请求没有任何对象被删除，直接返回全量失败即可。
• 若调用正常返回DeleteObjectsResult对象：
  • 调用result.getDeletedObjects()拿到的对象key列表，直接映射到响应的objectDeleted字段，这些是确定删除成功的对象
  • 调用result.getErrors()拿到的错误列表，每个元素包含出错的对象key、错误码、错误详情，直接映射到响应的error字段即可——单对象删除失败不会触发SDK抛出异常，所有部分失败的信息都会存在这个列表里。

错误场景模拟方法 #

本地测试不需要依赖线上真实错误，两种方式就能覆盖所有分支：

• 真实调用S3测试时，可以给桶配置自定义策略，禁止删除特定前缀的对象，构造批量请求时混合放入有权限删除、无权限删除的对象key，就能拿到部分成功、部分失败的真实返回。如果是版本化桶，尝试删除指定版本号但不带MFA令牌，也会触发单对象删除错误。
• 单元测试场景下，直接用Mockito等Mock工具构造DeleteObjectsResult实例，手动塞入自定义的成功对象、错误对象即可，不需要真实连接S3，构造出的返回和AWS线上真实返回结构完全一致，你之前用DTO模拟返回的测试逻辑是完全可行的。

注意：单次deleteObjects请求最多支持1000个对象，超过数量SDK会直接做本地参数校验抛出异常，业务层如果有更大批量的删除需求，需要提前做分片处理。

内容的提问来源于stack exchange，提问作者Breno Araripe