SST 项目中从 open-next 迁移到 @opennextjs/aws 的指南

在 SST (Serverless Stack) 项目中，近期出现了一个重要的变更：从 open-next 迁移到 @opennextjs/aws。这个变更从版本 3.1.4 开始生效，对于使用 SST 框架开发 Next.js 应用的开发者来说，需要了解这一变化并相应地调整项目配置。

背景与变更原因

SST 框架一直致力于为开发者提供最佳的 Serverless 开发体验。随着 Next.js 生态系统的演进，官方推荐的工具链也在不断优化。从 open-next 迁移到 @opennextjs/aws 正是这一演进过程的一部分，目的是提供更稳定、更高效的构建和部署体验。

变更影响

这一变更主要影响以下几个方面：

1. 构建命令的变化
2. 依赖管理的变化
3. 运行时配置的变化

解决方案

对于 SST v3 用户

在 SST v3 中，可以通过以下方式适配这一变更：

1. 在 sst.config.ts 文件中明确指定构建命令
2. 在项目中单独安装 @opennextjs/aws 依赖

配置示例：

new sst.aws.Nextjs("nextjs", {
  buildCommand: "yarn opennextjs-build",
  runtime: "nodejs20.x",
  path: ".",
});

然后在 package.json 中添加相应的脚本：

"scripts": {
  "opennextjs-build": "npx @opennextjs/aws build"
}

或者更简洁的方式是直接在配置中指定构建命令：

new sst.aws.Nextjs("nextjs", {
  buildCommand: "npx @opennextjs/aws build",
  runtime: "nodejs20.x",
  path: ".",
});

对于 SST v2 用户

SST v2 用户同样可以通过自定义 buildCommand 来适配这一变更。虽然具体的配置方式可能略有不同，但核心思路是一致的：明确指定使用 @opennextjs/aws 作为构建工具。

最佳实践

1. 版本锁定：建议在 package.json 中明确指定 @opennextjs/aws 的版本，以避免潜在的兼容性问题。

2. 构建缓存：考虑配置适当的构建缓存策略，以优化构建性能。

3. 环境变量管理：确保所有必要的环境变量在构建时和运行时都能正确传递。

4. 监控与日志：部署后，密切关注应用的性能和日志，确保一切按预期工作。

迁移后的验证

完成迁移后，建议进行以下验证：

1. 构建过程是否成功完成
2. 部署后的应用功能是否正常
3. 性能指标是否符合预期
4. 错误日志中是否有相关警告或错误

总结

这次从 open-next 到 @opennextjs/aws 的迁移是 SST 框架持续优化的一部分。虽然需要开发者做一些配置调整，但这些变化最终会带来更稳定、更高效的开发体验。通过遵循上述指南，开发者可以顺利完成迁移，并继续享受 SST 框架带来的开发便利。