如何删除AWS S3存储桶中同键名对象及子文件夹镜像副本

嘿，结合你的Prisma后端+Lambda图片缩放的场景，我来帮你搞定这两个S3删除问题，给你几个实用的方案：

问题1：删除S3存储桶中同键名的多个对象 #

哦对了，先澄清下：S3默认同一存储桶里的键是唯一的，但如果你的桶开启了版本化，同一个键会保留多个上传版本（比如多次上传同名文件），这应该就是你遇到的“同键名多个对象”的情况。下面是两种处理方式：

方法1：用AWS CLI批量删除 #

如果喜欢用命令行操作，可以先列出目标键的所有版本，再批量删除：

# 第一步：列出某个键的所有版本（替换成你的桶名和目标键）
aws s3api list-object-versions --bucket YOUR_BUCKET_NAME --prefix target-photo.jpg

# 第二步：批量删除所有版本和删除标记（把VERSION_ID换成实际的版本ID）
aws s3api delete-objects --bucket YOUR_BUCKET_NAME --delete '{"Objects": [{"Key": "target-photo.jpg", "VersionId": "v1"}, {"Key": "target-photo.jpg", "VersionId": "v2"}], "Quiet": true}'

如果要自动化处理，可以用jq解析输出批量生成删除列表：

# 生成版本列表文件
aws s3api list-object-versions --bucket YOUR_BUCKET_NAME --prefix target-photo.jpg | jq -r '.Versions[] | "{\"Key\": \"\(.Key)\", \"VersionId\": \"\(.VersionId)\"}"' > versions.json

# 执行批量删除
aws s3api delete-objects --bucket YOUR_BUCKET_NAME --delete "{\\"Objects\\": $(cat versions.json | paste -sd ',' -), \\"Quiet\\": true}"

方法2：用Node.js SDK集成到Prisma后端 #

因为你用Prisma，大概率是Node.js环境，直接写代码集成到后端逻辑里更方便：

import { S3Client, ListObjectVersionsCommand, DeleteObjectsCommand } from "@aws-sdk/client-s3";

// 初始化S3客户端（替换成你的区域）
const s3Client = new S3Client({ region: "us-east-1" });

async function deleteAllObjectVersions(bucketName, targetKey) {
  // 获取目标键的所有版本和删除标记
  const listCmd = new ListObjectVersionsCommand({
    Bucket: bucketName,
    Prefix: targetKey
  });
  const { Versions, DeleteMarkers } = await s3Client.send(listCmd);

  const objectsToDelete = [];
  // 添加所有版本
  if (Versions) {
    objectsToDelete.push(...Versions.map(v => ({ Key: v.Key, VersionId: v.VersionId })));
  }
  // 别忘了处理删除标记（如果有的话）
  if (DeleteMarkers) {
    objectsToDelete.push(...DeleteMarkers.map(dm => ({ Key: dm.Key, VersionId: dm.VersionId })));
  }

  if (objectsToDelete.length === 0) {
    console.log(`没有找到${targetKey}的任何版本`);
    return;
  }

  // 执行批量删除
  const deleteCmd = new DeleteObjectsCommand({
    Bucket: bucketName,
    Delete: { Objects: objectsToDelete, Quiet: true }
  });
  await s3Client.send(deleteCmd);
  console.log(`已删除${targetKey}的所有版本`);
}

// 调用示例：替换成你的桶名和目标键
deleteAllObjectVersions("my-image-bucket", "vacation.jpg");

问题2：删除S3子文件夹中与原图片键名相同的镜像副本 #

假设原图片是vacation.jpg，Lambda生成的副本在thumbnails/vacation.jpg、medium/vacation.jpg这类子文件夹里，下面是两种批量删除的方法：

方法1：用AWS CLI快速删除 #

用aws s3 rm的过滤规则，精准匹配所有子文件夹下的同名文件：

# 删除所有子文件夹下名为vacation.jpg的文件（替换桶名和文件名）
aws s3 rm s3://YOUR_BUCKET_NAME/ --recursive --exclude "*" --include "*/vacation.jpg"

解释：--exclude "*"先排除所有文件，再用--include "*/vacation.jpg"只保留任何子文件夹下的目标文件，不会误删根目录的原文件。

方法2：用Node.js SDK集成到后端 #

如果要和Prisma的删除逻辑联动（比如删除数据库记录时同时删S3副本），可以用这段代码：

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

const s3Client = new S3Client({ region: "us-east-1" });

async function deleteCopiesInSubfolders(bucketName, originalFileName) {
  let allMatchingObjects = [];
  let continuationToken;

  // 分页列出桶里的所有对象（处理大量文件的情况）
  do {
    const listCmd = new ListObjectsV2Command({
      Bucket: bucketName,
      ContinuationToken: continuationToken
    });
    const response = await s3Client.send(listCmd);

    // 筛选出子文件夹里的同名副本（键包含"/originalFileName"，排除根目录的原文件）
    const matches = response.Contents?.filter(obj => obj.Key.includes(`/${originalFileName}`)) || [];
    allMatchingObjects.push(...matches);
    continuationToken = response.NextContinuationToken;
  } while (continuationToken);

  if (allMatchingObjects.length === 0) {
    console.log(`没有找到${originalFileName}的子文件夹副本`);
    return;
  }

  // S3一次最多删1000个对象，所以分批次处理
  const batches = [];
  for (let i = 0; i < allMatchingObjects.length; i += 1000) {
    batches.push(allMatchingObjects.slice(i, i + 1000));
  }

  for (const batch of batches) {
    const deleteCmd = new DeleteObjectsCommand({
      Bucket: bucketName,
      Delete: {
        Objects: batch.map(obj => ({ Key: obj.Key })),
        Quiet: true
      }
    });
    await s3Client.send(deleteCmd);
  }

  console.log(`已删除${allMatchingObjects.length}个${originalFileName}的子文件夹副本`);
}

// 调用示例
deleteCopiesInSubfolders("my-image-bucket", "vacation.jpg");

一些额外提示 #

• 如果Lambda生成副本时用了固定前缀（比如resized/），可以在ListObjectsV2Command里加Prefix: "resized/"缩小范围，提升效率。
• 确保你的Prisma后端的IAM角色有S3的ListBucket和DeleteObject权限（版本化桶还要加DeleteObjectVersion）。
• 测试时可以先只打印匹配的键，不要执行删除，避免误删重要文件。

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