部署AWS CDK Pipeline失败：无法创建AWS CodePipeline

我在个人AWS账号中部署AWS CDK Pipeline时，遇到CloudFormation创建AWS::CodePipeline::Pipeline资源失败的问题，错误信息如下：

19:38:51 | CREATE_FAILED | AWS::CodePipeline::Pipeline | MyPipeline92D3D757
Internal Failure

在CloudFormation控制台查看堆栈，同样显示Pipeline创建失败。

以下是针对性的排查步骤：

• 验证IAM权限：确保执行CDK部署的身份（用户/角色）拥有创建CodePipeline及关联资源的完整权限，重点检查codepipeline:*、cloudformation:*、s3:*、iam:PassRole、codebuild:*这些权限是否配置到位。
• 查看CloudFormation事件详情：进入对应堆栈的「事件」标签，展开失败资源的事件链，查看关联资源是否有前置错误（比如依赖的S3桶或IAM角色创建失败），有时Internal Failure是由依赖资源问题引发的。
• 确认区域兼容性：检查当前使用的AWS区域是否支持CodePipeline的全部功能，避免使用边缘区域或刚上线的区域。
• 清理残留资源：如果之前有过失败部署，手动删除遗留的相关资源（如CDK创建的S3部署桶、未完成的Pipeline实例），再重新执行部署。
• 升级CDK版本：若使用的CDK版本较旧，可能存在已知的资源创建bug，运行npm install -g aws-cdk升级到最新稳定版本后重试。
• 检查Pipeline配置：核对代码中Pipeline的阶段、动作配置，比如源阶段的仓库地址、凭证是否正确，构建阶段的环境参数、镜像选择是否符合要求，排除配置拼写或逻辑冲突。

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