CDK部署报错：Module 'constructs'无IDependable导出成员

执行CDK部署脚本yarn run build-env-dev时触发以下TypeScript错误：

yarn run v1.22.19
warning package.json: No license field
$ ./app/node_modules/.bin/tsc -p .
Error: deploy/node_modules/aws-cdk-lib/aws-iam/lib/grant.d.ts(2,22): error TS2305: Module "constructs" has no exported member 'IDependable'.
Error: deploy/node_modules/aws-cdk-lib/aws-iam/lib/principals.d.ts(1,10): error TS2305: Module "constructs" has no exported member 'IDependable'.
Error: deploy/node_modules/aws-cdk-lib/aws-s3/lib/destination.d.ts(1,21): error TS2305: Module "constructs" has no exported member 'IDependable'.
error Command failed with exit code 2.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.
Error: Process completed with exit code 2.

已完成操作：

• 将根目录、app目录、deploy目录的aws-cdk-lib从2.12.0升级到2.79.1
• 根目录package.json新增constructs 3.4.297依赖

当前环境：多package目录结构（根、app、deploy），对CDK、Node.js、Yarn、TypeScript经验有限。

各目录package.json内容 #

根目录package.json #

{
  "name": "msft-service",
  "version": "0.0.1",
  "bin": {
    "msft-service-cdk": "bin/msft-service-cdk.js"
  },
  "scripts": {
    "setup:all": "(yarn install) && (cd app && yarn install) && (cd deploy && yarn install)",
    "build-env-dev": "./app/node_modules/.bin/tsc -p .",
    "prepare-deploy": "&& yarn run prepare-deploy ./scripts/copy-modules.sh",
    "watch": "tsc -w",
    "test": "jest",
    "cdk": "cdk",
    "lint": "tslint '*.ts'",
    "lint-fix": "tslint --fix -p tsconfig.json"
  },
  "devDependencies": {
    "@aws-cdk/assert": "^1.103.0",
    "@types/aws-lambda": "^8.10.85",
    "@types/jest": "^26.0.10",
    "@types/node": "14.0.23",
    "aws-cdk": "^1.103.0",
    "constructs": "3.4.297",
    "esbuild": "^0.14.22",
    "jest": "^26.4.2",
    "ts-jest": "^26.2.0",
    "ts-node": "^10.2.1",
    "tslint": "^5.5.0",
    "typescript": "^4.2.4"
  },
  "dependencies": {
    "@aws-cdk/aws-apigateway": "^1.103.0",
    "@aws-cdk/aws-backup": "^1.103.0",
    "@aws-cdk/aws-dynamodb": "^1.103.0",
    "@aws-cdk/aws-ec2": "^1.103.0",
    "@aws-cdk/aws-events-targets": "^1.103.0",
    "@aws-cdk/aws-iam": "^1.103.0",
    "@aws-cdk/aws-lambda": "^1.103.0",
    "@aws-cdk/aws-lambda-event-sources": "^1.103.0",
    "@aws-cdk/aws-lambda-nodejs": "^1.103.0",
    "@aws-cdk/aws-logs": "^1.103.0",
    "@aws-cdk/aws-logs-destinations": "^1.103.0",
    "@aws-cdk/aws-route53": "^1.103.0",
    "@types/needle": "^2.0.4",
    "@types/xml2js": "^0.4.5",
    "aws-cdk-lib": "2.79.1",
    "aws-sdk": "^2.509.0",
    "batch-write-all": "1.0.2",
    "constructs": "3.4.297",
    "needle": "^2.3.3",
    "path": "^0.12.7",
    "source-map-support": "^0.5.16",
    "uuid": "3.4.0",
    "xml-js": "^1.6.11",
    "xml2js": "0.4.23"
  }
}

app目录package.json #

{
  "name": "msft-service",
  "version": "0.0.1",
  "bin": {
    "msft-service-cdk": "bin/msft-service-cdk.js"
  },
  "scripts": {
    "build-env-dev": "./app/node_modules/.bin/tsc -p .",
    "prepare-deploy": "&& yarn run prepare-deploy ./scripts/copy-modules.sh",
    "watch": "tsc -w",
    "test": "jest",
    "cdk": "cdk",
    "lint": "tslint '*.ts'",
    "lint-fix": "tslint --fix -p tsconfig.json"
  },
  "devDependencies": {
    "@aws-cdk/assert": "^1.103.0",
    "@types/aws-lambda": "^8.10.85",
    "@types/jest": "^26.0.10",
    "@types/node": "14.0.23",
    "aws-cdk": "^1.103.0",
    "esbuild": "^0.14.22",
    "jest": "^26.4.2",
    "ts-jest": "^26.2.0",
    "ts-node": "^10.2.1",
    "tslint": "^5.5.0",
    "typescript": "^4.2.4"
  },
  "dependencies": {
    "@aws-cdk/aws-apigateway": "^1.103.0",
    "@aws-cdk/aws-backup": "^1.103.0",
    "@aws-cdk/aws-dynamodb": "^1.103.0",
    "@aws-cdk/aws-ec2": "^1.103.0",
    "@aws-cdk/aws-events-targets": "^1.103.0",
    "@aws-cdk/aws-iam": "^1.103.0",
    "@aws-cdk/aws-lambda": "^1.103.0",
    "@aws-cdk/aws-lambda-event-sources": "^1.103.0",
    "@aws-cdk/aws-lambda-nodejs": "^1.103.0",
    "@aws-cdk/aws-logs": "^1.103.0",
    "@aws-cdk/aws-logs-destinations": "^1.103.0",
    "@aws-cdk/aws-route53": "^1.103.0",
    "@types/needle": "^2.0.4",
    "@types/xml2js": "^0.4.5",
    "aws-cdk-lib": "2.79.1",
    "aws-sdk": "^2.509.0",
    "batch-write-all": "1.0.2",
    "needle": "^2.3.3",
    "path": "^0.12.7",
    "source-map-support": "^0.5.16",
    "uuid": "3.4.0",
    "xml-js": "^1.6.11",
    "xml2js": "0.4.23"
  }
}

deploy目录package.json #

{
  "name": "msft-service",
  "version": "0.0.1",
  "bin": {
    "msft-service-cdk": "bin/msft-service-cdk.js"
  },
  "scripts": {
    "build-env-dev": "./app/node_modules/.bin/tsc -p .",
    "prepare-deploy": "&& yarn run prepare-deploy ./scripts/copy-modules.sh",
    "watch": "tsc -w",
    "test": "jest",
    "cdk": "cdk",
    "lint": "tslint '*.ts'",
    "lint-fix": "tslint --fix -p tsconfig.json"
  },
  "devDependencies": {
    "@aws-cdk/assert": "^1.103.0",
    "@types/aws-lambda": "^8.10.85",
    "@types/jest": "^26.0.10",
    "@types/node": "14.0.23",
    "aws-cdk": "^1.103.0",
    "jest": "^26.4.2",
    "ts-jest": "^26.2.0",
    "ts-node": "^10.2.1",
    "typescript": "^4.2.4",
    "esbuild": "^0.14.22",
    "tslint": "^5.5.0"
  },
  "dependencies": {
    "@types/needle": "^2.0.4",
    "@types/xml2js": "^0.4.5",
    "@aws-cdk/aws-apigateway": "^1.103.0",
    "@aws-cdk/aws-dynamodb": "^1.103.0",
    "@aws-cdk/aws-ec2": "^1.103.0",
    "@aws-cdk/aws-iam": "^1.103.0",
    "@aws-cdk/aws-lambda": "^1.103.0",
    "@aws-cdk/aws-lambda-event-sources": "^1.103.0",
    "@aws-cdk/aws-route53": "^1.103.0",
    "@aws-cdk/aws-logs": "^1.103.0",
    "@aws-cdk/aws-logs-destinations": "^1.103.0",
    "@aws-cdk/aws-lambda-nodejs": "^1.103.0",
    "@aws-cdk/aws-events-targets": "^1.103.0",
    "@aws-cdk/aws-backup": "^1.103.0",
    "aws-sdk": "^2.509.0",
    "aws-cdk-lib": "2.79.1",
    "source-map-support": "^0.5.16",
    "uuid": "3.4.0",
    "xml2js": "0.4.23",
    "needle": "^2.3.3",
    "path": "^0.12.7",
    "xml-js": "^1.6.11",
    "batch-write-all": "1.0.2"
  }
}

核心问题分析 #

1. CDK版本混合：项目同时使用了CDK v1（@aws-cdk/aws-xxx包，版本1.103.0）和CDK v2（aws-cdk-lib，版本2.79.1），两个版本不兼容，引发依赖冲突。
2. constructs版本不匹配：CDK v2要求搭配constructs v10.x版本，你安装的3.4.297对应CDK v1，IDependable仅在constructs v10中存在，这是报错的直接原因。
3. 多目录依赖不一致：app和deploy目录未添加正确的constructs依赖，导致部署目录的aws-cdk-lib找不到所需类型。

具体修复步骤 #

1. 移除所有CDK v1依赖
   在根、app、deploy三个目录的package.json中，删除所有@aws-cdk/xxx开头的包（包括@aws-cdk/assert、@aws-cdk/aws-apigateway等），CDK v2的所有服务已整合到aws-cdk-lib中，无需单独安装这些包。

2. 统一添加正确版本的constructs依赖
   在三个目录的package.json的dependencies中添加：

   "constructs": "^10.0.0"
   

   （aws-cdk-lib 2.79.1兼容的constructs版本范围是^10.0.0，直接指定该范围即可）

3. 更新CDK CLI版本
   将三个目录中devDependencies里的aws-cdk升级到与aws-cdk-lib匹配的2.79.1版本：

   "aws-cdk": "2.79.1"
   

4. 清理依赖并重新安装

   • 分别在根、app、deploy目录执行：

     rm -rf node_modules yarn.lock
     yarn install
     

   • 或直接运行根目录的setup:all脚本：

     yarn run setup:all
     

5. 检查TypeScript配置
   确保每个目录的tsconfig.json中，compilerOptions未引用旧的CDK v1类型，比如types数组里不要包含@aws-cdk/*相关类型。

6. 验证修复
   重新执行部署脚本：

   yarn run build-env-dev
   

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