CodeCommit触发Jenkins作业异常：子目录变更误触发其他作业

1. 核对CodeCommit触发器配置 #

• 确认目标子目录对应的触发器绑定了正确的SNS主题，而非触发无关作业的主题。进入CodeCommit仓库触发器设置，查看该子目录的路径过滤规则对应的SNS主题ARN，对比两个作业关联的SQS队列所订阅的主题是否匹配预期。
• 验证路径过滤规则的准确性：比如子目录为src/service-a/，检查规则是否误写为src/service-b/，或使用了过宽的通配符（如src/*/导致匹配范围超出预期）。CodeCommit路径过滤支持*（匹配任意非路径分隔符字符）和**（匹配任意含路径分隔符的字符），需确保规则精准覆盖目标子目录。

2. 检查SNS主题订阅与过滤策略 #

• 查看触发无关作业的SQS队列是否意外订阅了目标子目录对应的SNS主题，或目标作业的SQS队列未正确订阅对应主题。进入SNS控制台，逐个查看主题的订阅列表，确认SQS队列与主题的绑定关系符合预期。
• 核对SNS主题的消息过滤策略：如果配置了过滤规则，确认目标子目录的提交消息是否被错误过滤，而无关作业的SQS队列的过滤策略反而匹配了该消息。重点检查referenceName（分支名）、event（事件类型）、files（文件路径）等过滤条件是否设置错误。

3. 验证Jenkins的SQS触发器配置 #

• 确认两个Jenkins作业的SQS触发器绑定了正确的SQS队列。进入Jenkins作业配置页面，查看“Amazon SQS Trigger”插件的队列URL，核对是否与预期队列一致。
• 检查Jenkins侧的路径过滤：如果作业配置了“Include paths”/“Exclude paths”规则，确认目标作业的规则包含提交的子目录，而无关作业的规则未错误覆盖该路径。

4. 追踪消息流转链路 #

• 手动提交一次目标子目录的代码变更，然后进入SQS控制台查看两个队列的消息：
  • 确认目标队列是否收到该提交消息，无关队列是否意外接收了消息。
  • 解析消息的detail字段，核对files数组中的路径是否匹配目标子目录，referenceName是否为预期分支。
• 若消息进入错误队列，说明SNS订阅或过滤策略存在问题；若消息进入正确队列但Jenkins未触发，问题出在Jenkins触发器配置或作业本身；若消息未进入正确队列，则需排查CodeCommit触发器配置或路径过滤规则。

5. 核对IAM权限配置 #

• 确认CodeCommit拥有向目标SNS主题发送消息的权限：查看SNS主题的访问策略，是否允许codecommit.amazonaws.com服务主体发布消息到该主题。
• 确认SNS拥有向目标SQS队列发送消息的权限：查看SQS队列的访问策略，是否允许对应SNS主题ARN向队列发送消息。
• 确认Jenkins拥有读取目标SQS队列的权限：检查Jenkins使用的IAM角色是否具备sqs:ReceiveMessage、sqs:DeleteMessage等权限，且资源范围包含目标队列ARN。

内容的提问来源于stack exchange，提问作者Mohammad Saifur Rahman