SST 3.1.38 部署 NextJS 应用时遇到的 AWS Provider 版本兼容性问题分析

问题背景

在使用 SST (Serverless Stack) 3.1.38 版本部署 NextJS 应用时，开发者遇到了一个与 AWS Provider 版本相关的运行时错误。错误信息显示 pulumi.runtime.invokeOutput is not a function，这表明在调用 Pulumi 运行时 API 时出现了兼容性问题。

错误现象

当开发者尝试部署应用时，控制台输出了以下关键错误信息：

TypeError: pulumi.runtime.invokeOutput is not a function
    at getPartitionOutput
    at normalizePartition
    at prepare
    at new Nextjs

错误发生在 AWS Provider 版本升级到 6.53.0 后，而在降级到 6.52.0 版本后问题得到解决。

技术分析

根本原因

这个问题的本质是 AWS Provider 6.53.0 版本中引入的变更与当前 SST 框架的 Pulumi 运行时接口不兼容。具体表现在：

1. invokeOutput 方法是 Pulumi 运行时 API 的一部分，用于异步调用资源操作
2. 在 AWS Provider 6.53.0 中，该方法可能被重命名、移除或修改了调用方式
3. SST 框架中的 getPartitionOutput 函数依赖于这个特定的 API 方法

影响范围

此问题主要影响：

• 使用 SST 3.1.38 版本的项目
• 部署 NextJS 应用的场景
• 显式或隐式使用 AWS Provider 6.53.0 的配置

解决方案

临时解决方案

在 sst.config.ts 中显式指定 AWS Provider 版本为 6.52.0：

export default $config({
  app(input) {
    return {
      // ...其他配置
      providers: {
        aws: {
          version: "6.52.0"
        }
      }
    };
  },
  // ...其他配置
});

长期解决方案

建议关注 SST 官方更新，等待以下情况之一：

1. SST 发布新版本适配 AWS Provider 6.53.0+
2. AWS Provider 修复向后兼容性问题
3. 官方提供明确的升级指南

最佳实践建议

1. 版本锁定：对于生产环境，建议在配置中显式指定所有依赖的 Provider 版本
2. 渐进升级：升级 Provider 版本时，先在开发/测试环境验证
3. 变更追踪：关注 AWS Provider 的变更日志，特别是涉及运行时 API 的变更
4. 错误处理：在配置中添加适当的错误处理和回退机制

技术深度解析

这个问题实际上反映了基础设施即代码(IaC)工具链中常见的版本兼容性挑战。Pulumi 作为 SST 的底层引擎，其运行时 API 的稳定性对整个工具链至关重要。

AWS Provider 6.53.0 的变更可能涉及：

• 内部方法重构
• 性能优化导致的 API 调整
• 与新版 Pulumi 引擎的适配

对于开发者而言，理解这种依赖关系链(SST → Pulumi → AWS Provider)有助于更快地定位和解决类似问题。

总结

在基础设施即代码的世界中，版本管理始终是一个需要谨慎对待的领域。这次 AWS Provider 6.53.0 与 SST 3.1.38 的兼容性问题提醒我们，即使是小版本号的升级也可能带来意想不到的影响。通过版本锁定和分阶段升级策略，可以最大限度地减少这类问题对开发流程的影响。