如何为所有CDK资源统一设置环境（Stage）名称？

方案1：封装基础堆栈类（推荐，可控性强） #

创建自定义基础堆栈类，把环境值和资源名称生成逻辑封装进去，所有业务堆栈继承该类，避免重复传参。

步骤1：定义基础堆栈类 #

import { Stack, StackProps } from 'aws-cdk-lib';
import { Construct } from 'constructs';

interface BaseStackProps extends StackProps {
  pipelineEnv: string;
  accountId: string;
}

export class BaseStack extends Stack {
  protected readonly pipelineEnv: string;
  protected readonly accountId: string;

  constructor(scope: Construct, id: string, props: BaseStackProps) {
    super(scope, id, props);
    this.pipelineEnv = props.pipelineEnv;
    this.accountId = props.accountId;
  }

  // 封装资源名称生成方法，自动追加环境后缀
  protected getResourceName(prefix: string, resourceType: string): string {
    return `${prefix}-${this.accountId}-${resourceType}-${this.pipelineEnv}`;
  }
}

步骤2：业务堆栈继承基础类 #

import { Bucket } from 'aws-cdk-lib/aws-s3';
import { BaseStack } from './base-stack';

interface MyServiceStackProps {
  pipelineEnv: string;
  accountId: string;
}

export class MyServiceStack extends BaseStack {
  constructor(scope: Construct, id: string, props: MyServiceStackProps) {
    super(scope, id, { ...props });

    // 直接调用基础类方法生成名称，无需手动传递pipelineEnv
    const artifactBucket = new Bucket(this, 'ArtifactBucket', {
      bucketName: this.getResourceName('bucket', 'artifact'),
    });

    const stateBucket = new Bucket(this, 'StateBucket', {
      bucketName: this.getResourceName('bucket', 'state'),
    });
  }
}

步骤3：在main.ts中初始化堆栈 #

import { App } from 'aws-cdk-lib';
import { MyServiceStack } from './my-service-stack';

const app = new App();
const env = app.node.tryGetContext('config');
const accountId = process.env.CDK_DEFAULT_ACCOUNT; // 或从上下文/环境变量获取

new MyServiceStack(app, 'MyServiceStack', {
  pipelineEnv: env,
  accountId: accountId,
});

app.synth();

方案2：使用CDK Aspect全局修改资源名称 #

如果不想修改现有堆栈结构，可利用CDK的Aspect机制，全局遍历所有资源并自动追加环境后缀。

步骤1：定义自定义Aspect #

import { IAspect } from 'aws-cdk-lib';
import { IConstruct } from 'constructs';
import { Bucket } from 'aws-cdk-lib/aws-s3';
import { Function } from 'aws-cdk-lib/aws-lambda';

export class EnvNameAspect implements IAspect {
  private readonly envSuffix: string;

  constructor(envSuffix: string) {
    this.envSuffix = envSuffix;
  }

  visit(node: IConstruct): void {
    // 处理S3 Bucket
    if (node instanceof Bucket) {
      const currentName = node.bucketName;
      if (currentName && !currentName.endsWith(`-${this.envSuffix}`)) {
        node.node.addPropertyOverride('BucketName', `${currentName}-${this.envSuffix}`);
      }
    }

    // 处理Lambda函数
    if (node instanceof Function) {
      const currentName = node.functionName;
      if (currentName && !currentName.endsWith(`-${this.envSuffix}`)) {
        node.node.addPropertyOverride('FunctionName', `${currentName}-${this.envSuffix}`);
      }
    }

    // 可扩展处理其他资源类型，如DynamoDB Table、ECS Cluster等
  }
}

步骤2：在main.ts中注册Aspect #

import { App, Aspects } from 'aws-cdk-lib';
import { MyServiceStack } from './my-service-stack';
import { EnvNameAspect } from './env-name-aspect';

const app = new App();
const env = app.node.tryGetContext('config');

const myStack = new MyServiceStack(app, 'MyServiceStack', {
  // 原有堆栈属性，无需传递pipelineEnv到资源层
});

// 为单个堆栈注册Aspect
Aspects.of(myStack).add(new EnvNameAspect(env));

// 若要全局应用到所有堆栈，注册到App即可：
// Aspects.of(app).add(new EnvNameAspect(env));

app.synth();

注意事项 #

• Aspect方式需要针对不同资源类型分别处理，因为不同资源的名称属性不同（如DynamoDB Table是tableName，S3是bucketName）。
• 若资源未显式指定物理名称，CDK会自动生成唯一名称，可根据需求决定是否追加后缀。
• 代码中加入后缀判断，避免重复追加。

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