单体仓库拆分AWS CDK栈独立部署遇‘无栈’错误求助

功能支持性确认 #

这种将CDK配置从根目录拆分到各微服务包、实现独立部署的方案是完全支持的，属于CDK在Monorepo场景下的常见最佳实践，问题出在局部配置的细节遗漏上。

核心排查点与修复方案 #

1. 检查cdk.json的入口文件配置 #

拆分后每个服务包的cdk.json必须指向自身的CDK应用入口，而非原根目录的路径：

• 错误示例（沿用根目录配置）："app": "npx ts-node lib/cdk-app.ts"
• 正确示例（service-a的配置）："app": "npx ts-node cdk/bin/service-a.ts"
  确保路径是相对于service-a目录的，CDK会基于当前工作目录解析该路径。

2. 验证CDK应用入口是否正确创建栈 #

打开service-a的CDK入口文件（如cdk/bin/service-a.ts），确认代码中确实实例化并关联了栈到App实例：

import { App, Stack } from 'aws-cdk-lib';

const app = new App();
// 必须创建栈实例并绑定到App
new Stack(app, 'ServiceAStack', {
  env: {
    account: process.env.CDK_DEFAULT_ACCOUNT,
    region: process.env.CDK_DEFAULT_REGION
  }
});
app.synth();

如果入口代码未创建栈，CDK就会触发"This app contains no stacks"错误。

3. 确认Turbo执行时的工作目录 #

Turbo默认会进入对应workspace目录（即service-a目录）执行脚本，但可以手动进入service-a目录直接执行CDK命令验证：

cd services/service-a
npx aws-cdk deploy --all -c branchName=dev -c environment=dev

如果手动执行同样报错，说明问题不在Turbo，而是service-a本地的CDK配置问题。

4. 修复TypeScript模块解析问题 #

如果服务中使用了路径别名（如@mine/common），需要在service-a的tsconfig.json中配置路径映射，并确保ts-node能解析这些别名：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@mine/common": ["../../common/src"]
    }
  },
  "ts-node": {
    "require": ["tsconfig-paths/register"]
  }
}

缺少该配置会导致ts-node无法加载依赖模块，CDK应用初始化失败，进而无法识别栈。

5. 检查依赖完整性 #

确保service-a的package.json中包含了CDK运行所需的核心依赖：

{
  "dependencies": {
    "aws-cdk-lib": "^2.0.0",
    "constructs": "^10.0.0"
  },
  "devDependencies": {
    "ts-node": "^10.0.0",
    "typescript": "^4.0.0"
  }
}

可以通过npm install在service-a目录下安装依赖，或利用Monorepo的workspace共享依赖（需确保根目录依赖已正确安装且workspace配置生效）。

总结 #

按照上述步骤排查，90%的概率是cdk.json入口路径错误或CDK入口未创建栈导致的问题。先通过手动进入服务目录执行CDK命令缩小问题范围，再针对性修复配置即可实现独立部署。

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