S3 PutObject添加IfNoneMatch: "*"无效，如何实现仅当对象不存在时才写入？

看起来你踩了S3条件请求的一个小坑！你用IfNoneMatch: "*"没生效，大概率是因为PutObject操作中这个参数的传递方式或者生效逻辑和你预期的不太一样，我来给你捋清楚两种可靠的实现方式：

方法一：修正If-None-Match请求头的传递方式 #

S3的If-None-Match: "*"确实能实现“对象已存在则拒绝写入”的逻辑，但在AWS SDK v3中，直接把IfNoneMatch作为顶级参数可能不会被正确映射到HTTP请求头里。你可以试试把它放到headers对象中，明确指定请求头：

const params = {
  Bucket: process.env.AWS_S3_PHOTO_BUCKET,
  Key: photo_name.toString(),
  Body: resized_img,
  ContentType: req.file.mimetype,
  headers: {
    "If-None-Match": "*"
  }
};
const command = new PutObjectCommand(params);
try {
  await AWS_S3.send(command);
  // 写入成功，说明对象之前不存在
} catch (err) {
  if (err.name === "PreconditionFailed") {
    // 捕获412错误，处理对象已存在的逻辑
    console.log("对象已存在，无法覆盖");
  } else {
    // 处理其他错误
    throw err;
  }
}

这样修改后，当目标Key的对象已经存在时，S3会返回412 Precondition Failed错误，你的代码就能捕获到这个异常，刚好符合“存在则失败、不存在则写入”的需求。

方法二：用S3原生条件表达式（更直观） #

如果你觉得请求头的方式不够直观，还可以用S3的条件表达式，直接明确指定“仅当对象不存在时才执行写入”，可读性更强：

const params = {
  Bucket: process.env.AWS_S3_PHOTO_BUCKET,
  Key: photo_name.toString(),
  Body: resized_img,
  ContentType: req.file.mimetype,
  Condition: "s3:ObjectExists = false"
};

或者也可以用对象形式的条件写法（兼容更多SDK版本）：

const params = {
  Bucket: process.env.AWS_S3_PHOTO_BUCKET,
  Key: photo_name.toString(),
  Body: resized_img,
  ContentType: req.file.mimetype,
  Condition: {
    StringEquals: {
      "s3:ObjectExists": "false"
    }
  }
};

这种方式和请求头的逻辑完全一致，都是当对象已存在时触发412错误，你只需要在代码中捕获异常即可。

为什么你原来的代码没生效？ #

大概率是因为AWS SDK v3中，顶级的IfNoneMatch参数在PutObjectCommand的参数映射中出了问题，没有被正确转换成HTTP请求头。换成headers对象里的If-None-Match就能解决这个映射问题，让S3正确识别你的预条件。

你可以先试试第一种修改，应该就能看到预期的效果了！

内容来源于stack exchange