SST 项目中 Next.js 应用 Lambda 超时配置指南

背景介绍

在 Serverless 架构中使用 Next.js 时，Lambda 函数的默认超时时间可能无法满足某些耗时较长的请求需求。SST (Serverless Stack) 作为一个流行的 Serverless 框架，提供了灵活的配置方式来调整这些参数。

问题现象

开发者在使用 SST 的 Next.js 组件时，经常会遇到 LambdaTimeoutError 错误。这表明 Lambda 函数在执行过程中超过了默认的超时限制（通常为 3 秒或 30 秒，取决于具体配置）。

解决方案

在 SST v2 中，NextjsSite 对象直接提供了 timeout 属性。但在 SST 的 ion 版本中，需要通过 transform 构造来配置超时时间。

正确配置方式

const web = new sst.aws.Nextjs("MyWeb", {
  transform: {
    server: {
      timeout: "40 seconds", // 可设置为 1 minute, 3 minutes 等
    },
  },
});

配置说明

1. transform 对象：这是 SST 提供的一个强大功能，允许开发者修改底层资源的配置
2. server 属性：针对 Next.js 的服务端渲染函数进行配置
3. timeout 值：支持字符串格式的时间描述，如 "30 seconds"、"1 minute"、"5 minutes" 等

常见误区

1. 错误的属性路径：

   • 使用 function 而不是 server
   • 将配置放在 defaults 或直接放在根对象中

2. 时间格式错误：

   • 使用数字而不是字符串
   • 使用不支持的格式如 "180 seconds" 而不是 "3 minutes"

验证方法

部署后，可以通过 AWS 控制台检查 Lambda 函数的配置，确认超时时间已按预期更新。

最佳实践

1. 根据应用的实际需求设置合理的超时时间
2. 对于长时间运行的任务，考虑拆分为异步处理
3. 配合监控和告警，及时发现和处理超时问题

通过正确配置 transform 属性，开发者可以轻松调整 Next.js 应用的 Lambda 超时设置，确保应用稳定运行。