使用CI/CD部署时未生成AwsSamAutoDependencyLayerNestedStack问题排查

可能原因及处理方式 #

• 构建缓存未刷新：sam build默认复用缓存，若依赖层变更未被识别，会跳过嵌套栈生成。在sam build中添加--no-cached参数强制全量构建：

  sam build --no-cached --parameter-overrides DeploymentPhase=staging DeploymentVersion=live --region ap-southeast-1
  

• 参数传递未触发嵌套栈条件：检查模板中AwsSamAutoDependencyLayerNestedStack的Condition配置，确认DeploymentPhase/DeploymentVersion参数值是否满足栈创建的触发条件，确保参数能正确传递到嵌套栈的逻辑中。

• SAM版本不一致：本地与CI/CD环境的SAM CLI版本可能存在差异，sam sync的新版本对依赖层嵌套栈的处理更完善。升级CI环境的SAM CLI到与本地一致的稳定版本。

• 构建产物未正确上传S3：sam deploy需将构建包上传至指定S3桶，若依赖层包未上传，CloudFormation无法创建嵌套栈。可在CI流程中添加步骤，验证.aws-sam/build目录的依赖层文件，以及S3桶内的对应资源是否存在。

• 空变更集跳过部署：--no-fail-on-empty-changeset会在无变更时跳过部署，若SAM未检测到依赖层变更，会忽略嵌套栈创建。临时移除该参数，查看变更集详情，确认是否包含嵌套栈的创建操作。

验证建议 #

• 本地执行sam build --no-cached后再运行sam deploy，确认是否能生成嵌套栈，排查环境差异。
• 查看CI流水线的部署日志，重点检查CloudFormation变更集内容，确认是否包含AwsSamAutoDependencyLayerNestedStack的创建条目。

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