AWS CodePipeline事件规则未触发 求排查方案

一、检查流水线部署阶段的事件输出配置 #

• 确认CDK中是否为CodePipeline的部署阶段配置了onStateChange事件，或是明确指定了阶段完成后要触发的目标。仅部署到S3的话，默认不会自动生成触发事件，得在CDK代码里显式添加阶段完成的事件通知逻辑。
• 打开CodePipeline控制台，查看对应部署阶段的“附加操作”，看有没有“通知”或“触发Lambda”的配置项，没有的话说明CDK里没正确定义触发规则。

二、验证EventBridge规则的触发条件 #

• 核对EventBridge规则的事件模式：事件源必须是aws.codepipeline，事件类型要包含CodePipeline Stage Execution Succeeded，还要指定对应的流水线名称和部署阶段名称，不能泛泛匹配。
• 检查规则的目标配置：Lambda函数和SNS主题有没有被正确关联，且规则状态是“启用”状态。

三、排查权限问题 #

• 查CodePipeline角色是否有events:PutEvents权限，要是缺这个权限，流水线完成后根本发不出EventBridge事件。
• 确认EventBridge的执行角色有没有调用Lambda和发布SNS消息的权限，同时检查Lambda和SNS的权限策略，是否允许EventBridge触发它们。
• 检查S3部署阶段的执行角色能不能正常完成部署，并且会向CodePipeline返回成功状态——要是部署阶段实际没标记成“成功”，后续触发逻辑肯定不会跑。

四、确认S3部署的完成状态 #

• 看CodePipeline控制台里部署阶段的详情，确认该阶段是不是显示“Succeeded”。要是部署有隐性失败（比如S3同步没做完但CodePipeline误标成功），得检查部署动作的输出配置，确保只有S3对象完全同步后才标记阶段成功。
• 在CDK里检查S3部署动作的配置，有没有设置正确的runOrder和successConditions，避免阶段提前结束。

五、正确查询CloudTrail日志 #

• 调整CloudTrail的查询条件：用事件源codepipeline.amazonaws.com，事件名称包含PutJobSuccessResult或StageExecutionSucceeded，同时指定流水线ARN作为资源条件，别漏了范围。
• 确认CloudTrail日志的时间范围覆盖流水线运行的完整时间段，而且日志所在区域和流水线区域一致。

六、手动触发流水线事件测试 #

• 在CDK代码里加临时测试逻辑，比如部署阶段完成后直接调用Lambda的invoke方法，或者发布SNS消息，验证目标资源能不能正常响应，排除触发链路之外的问题。

内容的提问来源于stack exchange，提问作者Nikola-Milovic