CDK Pipeline多阶段复用堆栈时Lambda Layer绑定失败问题排查

问题现象 #

在AWS CDK Pipeline中配置dev/uat/prod多阶段并复用CustomerStack时，执行cdk bootstrap命令触发以下错误：

C:\dev\aws-cdk\node_modules\aws-cdk-lib\aws-lambda\lib\code.ts:185
      throw new Error(`Asset is already associated with another stack '${cdk.Stack.of(this.asset).stackName}'. ` +
            ^
Error: Asset is already associated with another stack 'msm-customer'. Create a new Code instance for every stack.
    at AssetCode.bind (C:\dev\aws-cdk\node_modules\aws-cdk-lib\aws-lambda\lib\code.ts:185:13)
    at new LayerVersion (C:\dev\aws-cdk\node_modules\aws-cdk-lib\aws-lambda\lib\layers.ts:124:29)
    at new CustomerStack (C:\dev\aws-cdk\lib\CustomerStack.ts:22:17)

调试确认：注释Lambda Layer代码或仅保留单个阶段时，bootstrap命令可正常执行。

相关代码 #

PipelineStack.ts #

// 创建名为CodeRepo的CodeCommit仓库
const repo = new codecommit.Repository(this, 'CodeRepo', {
    repositoryName: "CodeRepo"
});

const pipeline = new CodePipeline(this, 'Pipeline-dev', {
    pipelineName: 'Pipeline-dev',
    synth: new CodeBuildStep('SynthStep-dev', {
        input: CodePipelineSource.codeCommit(repo, 'master'),
        installCommands: [
            'npm install -g aws-cdk'
        ],
        commands: [
            'npm ci',
            'npm run build',
            'npx cdk synth'
        ],
    })
});

// 添加三个部署阶段
pipeline.addStage(new PipelineStage(this, 'dev'));
pipeline.addStage(new PipelineStage(this, 'uat'));
pipeline.addStage(new PipelineStage(this, 'prod'));

PipelineStage.ts #

export class PipelineStage extends Stage {
    constructor(scope: Construct, id: string, props?: StageProps) {
        super(scope, id, props);

        new CustomerStack(this, 'msm-customer-' + id, {
            stackName: 'msm-customer',
            env: {
                account: process.env.ACCOUNT,
                region: process.env.REGION,
            },
        });
    }
}

CustomerStack.ts #

import { Duration, Stack, StackProps } from 'aws-cdk-lib';
import { Construct } from 'constructs';
import * as apigateway from 'aws-cdk-lib/aws-apigateway';
import * as lambda from 'aws-cdk-lib/aws-lambda';
import * as iam from 'aws-cdk-lib/aws-iam';
import * as ec2 from 'aws-cdk-lib/aws-ec2';
import 'dotenv/config';

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

        // 引用已有IAM角色
        const role = iam.Role.fromRoleArn(this, 'Role',
            `arn:aws:iam::${Stack.of(this).account}:role/` + process.env.IAM_ROLE,
            { mutable: false },
        );

        // 创建Lambda Layer
        const layer = new lambda.LayerVersion(this, 'msm-layer', {
            code: lambda.Code.fromAsset('resources/layer/customer'),
            description: 'Frontend common resources',
            compatibleRuntimes: [lambda.Runtime.NODEJS_14_X],
            removalPolicy: cdk.RemovalPolicy.DESTROY
        });

        // 创建Lambda函数
        const lambdaDefault = new lambda.Function(this, 'default', {
            runtime: lambda.Runtime.NODEJS_14_X,
            code: lambda.Code.fromAsset('resources/lambda/customer/default'),
            handler: 'index.handler',
            role: role,
            timeout: Duration.seconds(20),
            memorySize: 256,
            layers: [layer],
            allowPublicSubnet: true,
            vpcSubnets: { subnetType: ec2.SubnetType.PUBLIC }
        });

        // 其他代码
    }
}

问题原因 #

1. Stack名称冲突：所有阶段的CustomerStack都指定了相同的stackName: 'msm-customer'，导致CDK尝试创建多个同名Stack，触发资源绑定冲突。
2. Asset实例复用：lambda.Code.fromAsset生成的CDK Asset会绑定到第一个创建的Stack，后续阶段复用CustomerStack时，同一个Asset实例被尝试关联到其他Stack，触发报错。

解决方案 #

1. 给每个阶段的Stack分配唯一名称 #

修改PipelineStage.ts，为每个环境的Stack添加阶段ID后缀，确保名称唯一：

export class PipelineStage extends Stage {
    constructor(scope: Construct, id: string, props?: StageProps) {
        super(scope, id, props);

        new CustomerStack(this, 'msm-customer-' + id, {
            stackName: `msm-customer-${id}`,
            env: {
                account: process.env.ACCOUNT,
                region: process.env.REGION,
            },
        });
    }
}

2. 确保每个Stack的Asset独立 #

当前代码中lambda.Code.fromAsset是在CustomerStack构造函数内定义的，只要每个Stack名称唯一，CDK会自动为每个Stack生成独立的Asset实例，无需额外修改。

3. 可选：跨阶段共享Lambda Layer（如需环境共享） #

如果dev/uat/prod可以共享同一个Layer，可将Layer抽取到独立Stack，再在各个CustomerStack中引用：

// 新建LayerStack.ts
export class LayerStack extends Stack {
    public readonly customerLayer: lambda.LayerVersion;

    constructor(scope: Construct, id: string, props?: StackProps) {
        super(scope, id, props);

        this.customerLayer = new lambda.LayerVersion(this, 'msm-layer', {
            code: lambda.Code.fromAsset('resources/layer/customer'),
            description: 'Frontend common resources',
            compatibleRuntimes: [lambda.Runtime.NODEJS_14_X],
            removalPolicy: cdk.RemovalPolicy.DESTROY
        });
    }
}

// 修改PipelineStack.ts，创建LayerStack并传递给各阶段
const layerStack = new LayerStack(this, 'CustomerLayerStack', {
    env: { account: process.env.ACCOUNT, region: process.env.REGION }
});

pipeline.addStage(new PipelineStage(this, 'dev', { customerLayer: layerStack.customerLayer }));
pipeline.addStage(new PipelineStage(this, 'uat', { customerLayer: layerStack.customerLayer }));
pipeline.addStage(new PipelineStage(this, 'prod', { customerLayer: layerStack.customerLayer }));

// 修改PipelineStage.ts，接收Layer参数
export class PipelineStage extends Stage {
    constructor(scope: Construct, id: string, props: StageProps & { customerLayer: lambda.LayerVersion }) {
        super(scope, id, props);

        new CustomerStack(this, 'msm-customer-' + id, {
            stackName: `msm-customer-${id}`,
            env: { account: process.env.ACCOUNT, region: process.env.REGION },
            customerLayer: props.customerLayer
        });
    }
}

// 修改CustomerStack.ts，使用传入的Layer
export class CustomerStack extends Stack {
    constructor(scope: Construct, id: string, props: StackProps & { customerLayer: lambda.LayerVersion }) {
        super(scope, id, props);

        // 其他代码...

        const lambdaDefault = new lambda.Function(this, 'default', {
            // 其他配置...
            layers: [props.customerLayer],
            // 其他配置...
        });
    }
}

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