CodeBuild中CDK CLI与aws-cdk-lib版本不兼容问题求解

1. 确认cliVersion的正确配置位置 #

一定要在CodeBuildStep或ShellStep的cdkCommandOptions里设置cliVersion，这才会让CodeBuild环境安装指定版本的CLI。示例代码：

const synthStep = new pipelines.CodeBuildStep('Synth', {
  input: pipelines.CodePipelineSource.gitHub('your/repo', 'main'),
  installCommands: ['npm install'],
  commands: ['npm run build', 'npx cdk synth'],
  cdkCommandOptions: {
    cliVersion: '2.40.0'
  }
});

如果之前把cliVersion放在全局Pipeline参数里，大概率不会生效，因为每个构建步骤是独立的环境。

2. 手动强制安装指定版本CLI #

如果上面的配置还是没效果，直接在安装命令里全局安装指定版本的CDK CLI，彻底覆盖环境默认版本：

installCommands: [
  'npm install -g aws-cdk@2.40.0',
  'npm install'
],

3. 检查依赖锁文件 #

确认package-lock.json或yarn.lock里的aws-cdk-lib版本确实是2.40.0系列，没有被其他依赖降级。可以删掉锁文件，重新执行npm install生成新锁文件后提交到仓库。

4. 验证CLI实际版本 #

在构建命令里加一行验证命令，排查环境里的CLI版本是否真的匹配：

commands: [
  'cdk --version', // 打印当前CLI版本，看是不是2.40.0
  'npm run build',
  'npx cdk synth'
],

如果打印的版本不对，说明前面的安装步骤没生效，得检查有没有其他命令覆盖了CLI版本。

5. 严格锁定依赖版本（可选） #

把package.json里的aws-cdk-lib版本从^2.40.0改成2.40.0，去掉版本范围符号，避免npm自动升级到更高小版本，确保依赖和CLI版本完全一致。

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