使用AWS S3 V3 JavaScript SDK DeleteObjectCommand遇204响应的疑问

S3 对于无版本控制的桶，设计上就是幂等删除——不管目标对象是否存在，发送 DeleteObject 请求都会返回 204 状态码，所以仅靠 Delete 的响应确实没法判断对象是本来就不存在，还是真的被删除了。要确认对象是否已删除，可以用以下几种方法：

方法一：用 HeadObjectCommand 检查对象存在性 #

这是最高效的方式，因为 HeadObject 只请求对象的元数据，不返回内容，开销很小。如果对象不存在，SDK 会抛出 NotFound 错误：

import { HeadObjectCommand } from "@aws-sdk/client-s3";

async function isObjectDeleted(s3Client, bucketName, filename) {
  try {
    await s3Client.send(new HeadObjectCommand({
      Bucket: bucketName,
      Key: filename
    }));
    // 走到这里说明对象还存在
    return false;
  } catch (error) {
    if (error.name === "NotFound") {
      // 对象不存在（已删除或从未存在）
      return true;
    }
    // 其他错误，比如权限问题，需要单独处理
    throw error;
  }
}

// 调用示例：在 Delete 之后检查
await S3.send(new DeleteObjectCommand({ Bucket: bucketName, Key: filename }));
const deleted = await isObjectDeleted(S3, bucketName, filename);
console.log(deleted ? "文件已删除" : "文件仍存在");

方法二：用 ListObjectsV2Command 遍历桶内对象 #

适合需要批量确认或者需要查看桶内对象列表的场景，通过过滤目标 Key 来判断是否存在：

import { ListObjectsV2Command } from "@aws-sdk/client-s3";

async function checkObjectInBucket(s3Client, bucketName, filename) {
  const command = new ListObjectsV2Command({
    Bucket: bucketName,
    Prefix: filename // 用前缀过滤，精准匹配目标Key
  });
  const response = await s3Client.send(command);
  
  // 检查返回的对象列表中是否有目标Key
  return response.Contents?.some(obj => obj.Key === filename) || false;
}

// 调用示例
const exists = await checkObjectInBucket(S3, bucketName, filename);
console.log(exists ? "文件仍存在" : "文件已删除");

注意：如果桶内对象数量超过 1000，ListObjectsV2 会分页返回，需要循环处理 NextContinuationToken 来遍历所有对象。

方法三：用 GetObjectCommand 尝试获取对象 #

如果需要验证对象内容是否真的不存在，可以用 GetObject，不过这个方法会请求对象内容，开销比 HeadObject 大：

import { GetObjectCommand } from "@aws-sdk/client-s3";

async function isObjectDeleted(s3Client, bucketName, filename) {
  try {
    await s3Client.send(new GetObjectCommand({
      Bucket: bucketName,
      Key: filename
    }));
    return false;
  } catch (error) {
    if (error.name === "NotFound") {
      return true;
    }
    throw error;
  }
}

总结 #

• 优先用 HeadObjectCommand，高效且能精准判断对象是否存在；
• 批量场景用 ListObjectsV2Command；
• 需要验证内容时用 GetObjectCommand。

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