AWS CDK 在 Node.js 22 运行时合成性能下降问题分析

问题背景

近期 AWS CDK 用户报告了一个关键性能问题：当开发环境从 Node.js 18/20 升级到 Node.js 22 后，CDK 合成（synth）操作的时间出现了显著增长。这一现象在大型服务中尤为明显，有些案例显示合成时间从原来的 2 分钟激增至 15 分钟以上。

问题表现

性能下降呈现出以下特征：

1. 与服务规模成正比：小型服务（约50个资源）合成时间从15秒增加到20秒；大型服务（数百个资源）则从2分钟暴增至15分钟以上
2. 多环境合成时问题加剧：当同时为多个区域和账户合成时，性能下降更为显著
3. 跨平台一致性：问题在 MacOS 和 GitHub Actions 环境中均能复现

根本原因分析

经过技术团队深入调查，发现性能问题主要与以下因素相关：

1. TypeScript 运行时影响：使用 ts-node 执行 TypeScript 代码时，Node.js 22 表现出明显的性能下降
2. 大型包导入问题：当 CDK 应用导入大型 CommonJS 模块（特别是未经优化的约800KB的包）时，问题会加剧
3. DataDog 追踪工具干扰：使用 dd-trace 包进行应用性能监控时，会显著拖慢合成速度

解决方案

针对上述问题根源，推荐以下优化方案：

1. 构建流程优化

建议将开发流程从直接运行 TypeScript 改为先编译后执行：

npx tsc
node bin/app.js

这种方法完全避免了 ts-node 的性能开销，在 Node.js 22 环境下能获得最佳性能。

2. 运行时替换

如果必须直接执行 TypeScript，可以考虑用 tsx 替代 ts-node：

npm install -g tsx
tsx bin/app.ts

tsx 在性能上优于 ts-node，特别是在 Node.js 22 环境下。

3. 依赖管理优化

对于大型 CommonJS 模块：

• 检查是否真正需要导入整个包
• 考虑按需导入特定模块而非整个包
• 评估是否可以将大型依赖拆分为更小的模块

4. 监控工具配置

如果使用 DataDog 进行监控：

DD_TRACE_ENABLED=false cdk synth

临时禁用追踪可以立即恢复正常的合成速度，但这只是权宜之计。长期解决方案需要等待 DataDog 团队修复其追踪工具与 Node.js 22 的兼容性问题。

性能对比数据

优化前后的典型性能对比：

场景	Node.js 20	Node.js 22 (优化前)	Node.js 22 (优化后)
小型服务	15s	20s	15s
大型服务	2m	15m+	30s
多环境合成	2m	15m+	2m

最佳实践建议

1. 渐进式升级：在全面迁移到 Node.js 22 前，先在测试环境验证合成性能
2. 性能基准测试：建立合成时间的性能基准，便于及时发现退化
3. 依赖审查：定期审查 CDK 应用的依赖关系，移除不必要的重型依赖
4. 构建流程标准化：考虑将 TypeScript 编译步骤纳入 CI/CD 流程

总结

AWS CDK 在 Node.js 22 环境下的性能问题主要源于运行时和工具链的兼容性挑战。通过优化构建流程、替换性能瓶颈工具以及合理管理依赖，开发者可以显著改善合成性能。对于使用应用性能监控工具的场景，需要关注相关工具对 Node.js 新版本的支持情况。

随着 Node.js 生态系统的持续演进，这类性能问题有望在未来版本中得到根本解决。在此之前，采用本文推荐的优化策略可以帮助团队保持高效的开发体验。