s3.CopyObject添加新元数据失败问题排查求助

你的代码执行后元数据未生效有两个核心原因：

1. S3 CopyObject 接口默认行为是完整复制源对象的所有原有元数据，请求中携带的新元数据参数不会生效，除非显式声明要替换元数据。你代码中把元数据替换相关的配置注释掉了，且注释的参数写法不符合JavaScript AWS SDK的规范：SDK调用时不需要传带x-amz-前缀的原始HTTP头作为顶层参数，正确的参数名为MetadataDirective，且取值必须为大写字符串REPLACE，参数名、取值格式错误加上被注释，导致元数据替换逻辑根本没有触发。
2. 即使修正了CopyObject参数，你还会遇到和PutObject一样的循环触发问题：CopyObject操作本身也会生成新的S3 PUT事件，会再次触发Lambda执行，必须加拦截逻辑避免无限递归。

• 给copyObject调用补充必填的MetadataDirective: 'REPLACE'参数，强制S3使用请求中传入的新元数据覆盖原有元数据
• 新增递归拦截逻辑：每次Lambda触发时先检查当前对象的CacheControl值，如果已经是目标值就直接退出，不再执行复制操作，从根源避免循环触发
• 对CopySource中的对象Key做URL编码，兼容Key中包含空格、特殊字符、中文的场景，避免调用报错
• 确保Lambda执行角色已绑定S3相关权限：包含s3:GetObject、s3:PutObject权限即可满足copyObject操作需求

const AWS = require('aws-sdk');
const s3 = new AWS.S3();
const TARGET_CACHE_CONTROL = 'max-age=3600;s-maxage=3600';

exports.handler = async (event) => {
    const bucket = event.Records[0].s3.bucket.name;
    const key = decodeURIComponent(event.Records[0].s3.object.key.replace(/\+/g, ' '));
    
    // 先查询现有对象元数据，已经配置过缓存头就直接退出，避免循环触发
    const headRes = await s3.headObject({
        Bucket: bucket,
        Key: key
    }).promise();
    if (headRes.CacheControl === TARGET_CACHE_CONTROL) {
        console.log(`Object ${key} already has correct cache control, skip`);
        return;
    }

    // 执行元数据替换
    const copyParams = {
        Bucket: bucket,
        Key: key,
        CopySource: encodeURIComponent(`${bucket}/${key}`),
        CacheControl: TARGET_CACHE_CONTROL,
        MetadataDirective: 'REPLACE',
        // 如果需要保留原有自定义元数据，把headRes里的Metadata透传过来即可
        Metadata: headRes.Metadata || {}
    };

    await s3.copyObject(copyParams).promise();
    console.log(`Successfully set cache control for ${key}`);
};

注意：如果你原来的对象上配置了自定义用户元数据（x-amz-meta-*开头的字段），一定要在copyParams里把查询到的Metadata字段透传进去，开启REPLACE模式后如果不传Metadata字段，原有自定义元数据会被清空。

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