AWS Lambda在CodeCommit推送Git标签时未触发问题求助

问题根源 #

你配置的Lambda触发器分支过滤仅针对refs/heads/下的分支（develop、master），而Git标签的引用路径是refs/tags/，不在当前的分支匹配范围内，因此即使勾选了createReference事件，推送标签也不会触发触发器。

解决思路与步骤 #

1. 调整触发器的分支匹配规则 #

修改Lambda触发器的Branches配置，将标签的引用路径加入过滤规则：

• 如果需要触发所有标签：将Branches设置为 develop, master, refs/tags/*
• 如果只需要触发特定前缀的标签（比如v开头的版本标签）：可以用 refs/tags/v*
• CodeCommit的分支字段支持通配符，*匹配任意字符序列，?匹配单个字符

2. 验证事件类型配置 #

• 确认触发器的Events选项已勾选createReference（创建标签属于该事件类型）
• 可临时将Events改为all进行测试，排除事件类型配置错误的可能

3. 检查触发器权限策略 #

确认CodeCommit服务有权限调用你的Lambda函数：

• 查看触发器的权限策略（在Lambda触发器配置页的"Permissions"部分），确保Service principal为codecommit.amazonaws.com，且资源路径包含你的Lambda ARN
• 关键策略片段示例：

  {
    "Effect": "Allow",
    "Principal": {
      "Service": "codecommit.amazonaws.com"
    },
    "Action": "lambda:InvokeFunction",
    "Resource": "arn:aws:lambda:us-east-1:123456789012:function:your-lambda-function",
    "Condition": {
      "ArnLike": {
        "AWS:SourceArn": "arn:aws:codecommit:us-east-1:123456789012:my-codecommit-repo"
      }
    }
  }
  

4. 排查日志定位问题 #

• CloudTrail日志：搜索CodeCommit的CreateReference事件，确认标签推送是否生成了该事件，以及是否有调用Lambda的失败记录
• CloudWatch Logs：查看Lambda函数的日志流，检查是否有触发请求或错误信息（比如权限拒绝、事件过滤不匹配）

5. 确认标签推送状态 #

执行git push --tags后，登录CodeCommit仓库控制台，检查"Tags"页面是否显示刚推送的标签，确保标签已成功同步到仓库

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