如何在AWS CDK中获取CodeBuild暴露的环境变量？

核心问题说明 #

CODEBUILD_SOURCE_VERSION是CodeBuild自动注入的保留环境变量，用户不能手动定义（这就是你之前设置env: { ["CODEBUILD_SOURCE_VERSION"] : branchName }时报错的原因），你只需要在CDK代码中读取它即可。

具体实现步骤 #

1. 在目标堆栈代码中读取环境变量
   在你要部署的堆栈构造函数里，直接通过process.env获取这个变量，并用它动态生成堆栈名称：

   import { Stack, StackProps } from 'aws-cdk-lib';
   import { Construct } from 'constructs';
   
   export class BackendStack extends Stack {
     constructor(scope: Construct, id: string, props?: StackProps) {
       // 读取CodeBuild自动注入的变量，添加默认值避免本地测试报错
       const sourceBranch = process.env.CODEBUILD_SOURCE_VERSION || 'main';
       // 动态拼接堆栈名称
       super(scope, `${id}-${sourceBranch}`, props);
   
       // 此处添加堆栈内的资源定义（如Lambda、DynamoDB等）
     }
   }
   

2. 确保Pipeline配置正确传递变量
   你当前的Pipeline配置已经满足要求：

   • 启用了codeBuildCloneOutput: true，这个配置会让CodeBuild正确初始化所有内置环境变量；
   • 源码来源是CodeCommit的指定分支，CODEBUILD_SOURCE_VERSION会自动被设为该分支的名称。

3. 本地测试注意事项
   本地运行cdk synth时，CODEBUILD_SOURCE_VERSION环境变量不存在，所以一定要设置默认值（比如上面的'main'），避免代码报错。

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