Skip to content

CDK CLI and aws-cdk-lib version mismatch leads to deployment errors #75

@Diluka

Description

@Diluka

Describe the bug
The example package.json uses different versions for aws-cdk (CLI) and aws-cdk-lib (library). For example:

"devDependencies": {
  "aws-cdk": "2.121.1"
},
"dependencies": {
  "aws-cdk-lib": "2.189.1"
}

This version mismatch causes deployment errors such as:

This CDK CLI is not compatible with the CDK library used by your application. Please upgrade the CLI to the latest version.
(Cloud assembly schema version mismatch: Maximum schema version supported is 36.0.0, but found 41.0.0)

Expected behavior
The project should work out of the box without version mismatch errors. The aws-cdk CLI version should match the aws-cdk-lib version in package.json to avoid schema incompatibility.

Desktop (please complete the following information):

  • OS & version: [Any]
  • Node version (node -v): [Any recent LTS]
  • npm version (npm -v): [Any recent]

Additional context
See CDK documentation for details: https://docs.aws.amazon.com/cdk/v2/guide/work-with-cdk-typescript.html#typescript-dependencies

Suggested fix:
Align the aws-cdk devDependency version with the aws-cdk-lib dependency version in the example package.json (e.g., both set to 2.189.1). This will help users avoid deployment errors related to schema version mismatch.


I tried updating both packages to the latest versions:

"aws-cdk": "^2.1031.0",
"aws-cdk-lib": "^2.221.0"

After that, running npx cdk bootstrap succeeded without any issues.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions