AWS CDK未修改Deployment逻辑ID，API Gateway仍自动更新问题求助

核心问题分析 #

默认情况下，AWS CDK会将Lambda的代码变更关联到API Gateway的Deployment资源中——只要Lambda代码更新，CDK会自动认为API的集成配置发生变化，进而触发Deployment的更新，即使你没有修改Deployment的逻辑ID。要实现“仅修改Deployment逻辑ID时才更新对应阶段”，核心是切断Deployment与Lambda代码变更的自动依赖，让Deployment的更新完全由你手动控制。

具体实现方案 #

1. 禁用API自动部署，手动创建独立Deployment

首先关闭API Gateway的自动部署功能，为每个阶段手动创建独立的Deployment资源，并通过手动维护的版本标识控制Deployment的更新触发：

import * as cdk from 'aws-cdk-lib';
import * as apigateway from 'aws-cdk-lib/aws-apigateway';
import * as lambda from 'aws-cdk-lib/aws-lambda';

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

    // 定义Lambda函数
    const helloLambda = new lambda.Function(this, 'HelloLambda', {
      runtime: lambda.Runtime.NODEJS_18_X,
      handler: 'index.handler',
      code: lambda.Code.fromAsset('lambda'),
    });

    // 创建API Gateway，禁用自动部署
    const api = new apigateway.RestApi(this, 'HelloApi', {
      deploy: false,
    });

    // 添加API资源与Lambda集成
    const helloResource = api.root.addResource('hello');
    helloResource.addMethod('GET', new apigateway.LambdaIntegration(helloLambda));

    // V1阶段Deployment：仅修改版本号才触发更新
    const v1DeployVersion = 'v1.2'; // 手动修改此值，才会更新V1阶段
    new apigateway.Deployment(this, `ApiDeployment-v1-${v1DeployVersion}`, {
      api,
      description: `V1 Stage Deployment, Version: ${v1DeployVersion}`,
    }).stageName = 'v1';

    // V2阶段Deployment：独立维护版本
    const v2DeployVersion = 'v2.0';
    new apigateway.Deployment(this, `ApiDeployment-v2-${v2DeployVersion}`, {
      api,
      description: `V2 Stage Deployment, Version: ${v2DeployVersion}`,
    }).stageName = 'v2';
  }
}

2. 关键逻辑说明

• 禁用自动部署：通过deploy: false关闭CDK自动生成Deployment的行为，完全由你手动管理每个阶段的Deployment。
• 手动版本控制：每个Deployment的逻辑ID包含手动维护的版本号（如ApiDeployment-v1-v1.2），只有当你修改这个版本号时，CDK才会识别为需要创建新的Deployment资源，进而更新对应的API阶段。
• 解耦Lambda与Deployment：此时Lambda的代码变更只会更新Lambda函数本身，不会触发API Gateway的Deployment更新——因为Deployment不再依赖Lambda的代码哈希。

3. 批量管理优化（可选）

可以将版本号提取到CDK上下文文件（cdk.context.json）中，方便统一管理多阶段的版本：

{
  "apiDeploymentVersions": {
    "v1": "v1.2",
    "v2": "v2.0"
  }
}

然后在代码中读取上下文参数：

const deploymentVersions = this.node.tryGetContext('apiDeploymentVersions');
const v1DeployVersion = deploymentVersions.v1;

4. 临时跳过部署的命令行方式

如果只是临时不想更新某个阶段的Deployment，可以在部署时排除对应的资源：

cdk deploy --all --exclude YourStackName/ApiDeployment-v1-v1.2

内容的提问来源于stack exchange，提问作者Wai Yan Hein