跨栈共享API Gateway时移除Lambda集成部署失败求解决方案

问题背景 #

在AWS CDK TypeScript中采用跨栈共享RestAPI模式：公共栈创建RestAPI，其他业务栈（如用户栈）向该API添加资源和Lambda集成，此前运行正常。但移除用户栈中的Lambda集成时部署失败，报错：

Export users-stack:ExportsOutputFnGetAttusersstackauthorizeuserC81C1452ArnB7D2BE00 cannot be deleted as it is in use by common-stack

根源是CloudFormation部署顺序问题：先部署用户栈删除目标Lambda，此时公共栈的RestAPI仍保留对该Lambda的引用（尚未重新部署），CloudFormation无法自动推断后续公共栈会移除该引用，因此阻止删除导出。

可行解决方案 #

• 分阶段部署
  1. 先修改公共栈代码，彻底移除对用户栈目标Lambda的所有引用（包括集成配置、授权器、相关权限等），单独部署公共栈。此时公共栈不再依赖用户栈的导出项。
  2. 再部署用户栈，删除不再被引用的Lambda函数及对应的导出配置。
• 临时占位过渡
  1. 在公共栈中，将原有的目标Lambda集成替换为一个临时的空Lambda函数（仅返回基础响应即可），部署公共栈。
  2. 部署用户栈，删除目标Lambda及导出。
  3. 最后将公共栈中的临时占位Lambda集成移除，重新部署公共栈。
• 优化跨栈引用管理
  避免直接依赖CloudFormation自动生成的导出项，改用CDK的Stack.exportValue()和Fn.importValue()显式管理跨栈引用。同时在移除集成时，务必检查公共栈模板，确保没有残留任何对目标Lambda ARN的引用（包括隐藏的权限资源、日志配置等）。
• 手动清理（应急方案）
  若上述方法无效，可先在CloudFormation控制台的「导出」列表中找到报错的导出项，确认公共栈已无引用后手动删除该导出，再重新执行部署。此操作需谨慎，避免误删其他依赖项。

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