CDK跨区域多子栈部署问题：无通配符/--all无法部署子栈

问题描述 #

通过CDK部署主栈MultiStackRootStack，该主栈需在多区域创建MultiStackStorageStack和MultiStackQueueStack子栈。但实际部署时遇到以下问题：

• 直接部署MultiStackRootStack仅生成IAM角色和主栈同区域的S3桶，其他区域子栈无部署痕迹
• 使用通配符MultiStackRootStack*结果与直接部署主栈一致
• 使用MultiStackRootStack/*仅部署子栈，主栈不会被部署
• 将子栈改为继承NestedStack后，虽能通过主栈部署所有资源，但无法实现跨区域部署

示例代码 #

主栈代码

export class MultiStackRootStack extends cdk.Stack {
  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
    super(scope, id, props);

    const someRole = new iam.Role(
      this,
      "Lambda_role",
      {
        assumedBy : new iam.CompositePrincipal(
          new iam.ServicePrincipal("edgelambda.amazonaws.com"),
          new iam.ServicePrincipal("lambda.amazonaws.com"),
        ),
      }
    )

    let regions: string[] =  [
      "us-east-1",
      "us-east-2",
      "us-west-1",
      "us-west-2"
    ];
    
    regions.forEach(region => {
      new MultiStackStorageStack(this, `StorageStack-${region}`, {
         env: {
          region: region,
          account: "<account #>"
         }
        }
      );

      new MultiStackQueueStack(this, `QueueStack-${region}`, {
        env: {
         region: region,
         account: "<account #>"
        }
       }
     );
    });
}

存储子栈代码

export class MultiStackStorageStack extends cdk.Stack {
  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
    super(scope, id, props);

    console.log(`Storage Stack ${props?.env?.region}`)

    const bucket = new s3.Bucket(scope, `Bucket-${props?.env?.region}`, {
      blockPublicAccess: s3.BlockPublicAccess.BLOCK_ALL,
      encryption: s3.BucketEncryption.S3_MANAGED,
      enforceSSL: true,
      versioned: true,
      removalPolicy: RemovalPolicy.DESTROY,
      bucketName: `myuniquetestbucket-${props?.env?.region}`
    });
    
  }
}

队列子栈代码

export class MultiStackQueueStack extends cdk.Stack {
  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
    super(scope, id, props);

    console.log(`Queue Stack ${props?.env?.region}`)

    const queue = new sqs.Queue(this, `TheQueue-${props?.env?.region}`, {
      queueName: `TheQueue-${props?.env?.region}`,
    });
    
  }
}

问题原因与解决方案 #

1. 独立栈的部署逻辑 #

CDK中，你在MultiStackRootStack里创建的MultiStackStorageStack和MultiStackQueueStack是独立的CloudFormation栈，并非主栈的嵌套资源。主栈和子栈仅在CDK构造树中存在父子关系，但CDK CLI默认只会部署你明确指定的栈，不会自动包含构造树中的其他独立栈：

• 执行cdk deploy MultiStackRootStack时，CLI仅处理主栈，子栈属于独立实体，不在部署范围内
• MultiStackRootStack*通配符无法匹配子栈，因为子栈的完整ID格式为MultiStackRootStack/StorageStack-us-east-1；而MultiStackRootStack/*仅匹配子栈，不包含主栈

2. 代码中的关键错误 #

在MultiStackStorageStack中，创建S3 Bucket时使用了scope（即主栈MultiStackRootStack）作为父构造，而非this（子栈自身）：

// 错误写法：Bucket归属于主栈，部署在主栈区域
const bucket = new s3.Bucket(scope, `Bucket-${props?.env?.region}`, { ... });

// 正确写法：Bucket归属于子栈，部署在子栈指定区域
const bucket = new s3.Bucket(this, `Bucket-${props?.env?.region}`, { ... });

这就是部署主栈时会生成同区域S3桶的核心原因——该Bucket实际是主栈的资源，而非子栈的。

3. 正确的部署方式 #

要同时部署主栈和所有跨区域子栈，推荐两种可靠方式：

• 使用cdk deploy --all：CLI会遍历所有生成的栈，按依赖顺序自动部署（包括跨区域子栈）
• 明确指定所有栈的完整ID：比如cdk deploy MultiStackRootStack MultiStackRootStack/StorageStack-us-east-1 ...，适合单个栈的调试场景

关于NestedStack的说明 #

NestedStack是CloudFormation的嵌套栈，必须与父栈同区域，因此确实无法满足跨区域部署需求，你的场景下应继续使用独立栈模式。

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