使用OpenNext v3外部中间件部署Next.js到AWS时Lambda Edge环境变量报错求助

问题描述 #

我正在尝试用OpenNext v3把Next.js应用部署到AWS，想用它新出的外部中间件功能，但部署时遇到了Lambda Edge的限制报错——Lambda Edge函数不允许设置环境变量，但OpenNext生成的Edge中间件Lambda函数自动加了一堆环境变量，导致部署失败。

具体报错信息：

Site sst:aws:Nextjs → SiteCdnDistribution aws:cloudfront:Distribution
sdk-v2/provider2.go:515: sdk.helper_schema: updating CloudFront Distribution (123): operation error CloudFront: UpdateDistribution, https response error StatusCode: 400, RequestID: 69b2ada4-1f61-4faf-96c1-4e04c714b4b7, InvalidLambdaFunctionAssociation: The function cannot have environment variables. Function: arn:aws:lambda:us-east-1:123:function:ashrae-research-test-SiteEdgeMiddlewareFunction-erhbndat:9: provider=aws@6.66.2
ELIFECYCLE  Command failed with exit code 1.

我不太理解为什么OpenNext明明知道Lambda Edge的这个限制，还会给外部中间件函数加环境变量？有没有办法阻止这个行为？

我的OpenNext配置文件如下：

const config = {
    default: {},
    middleware: {
        external: true,
    },

}

export default config;

可能的解决思路 #

根据Lambda Edge的特性和OpenNext的工作逻辑，给你几个排查方向：

• 升级OpenNext到最新版本
  这大概率是OpenNext v3刚推出时的兼容性bug，官方可能已经修复了这个问题。先把OpenNext升级到最新稳定版，再重新部署试试。

• 检查环境变量的来源并显式禁用传递
  看看你的项目里有没有.env文件或者SST配置中自动注入的环境变量，有些工具会默认把项目环境变量传递给所有Lambda函数，包括Edge函数。你可以尝试在OpenNext配置里显式声明不传递任何环境变量：

  const config = {
      default: {},
      middleware: {
          external: true,
          env: {} // 强制不传递环境变量
      },
  }
  export default config;
  

• 临时调整生成的部署模板
  如果升级和配置调整都没用，可以尝试找到SST/OpenNext生成的CloudFormation模板，找到Edge中间件Lambda函数的定义部分，移除其中的Environment配置块。不过这是临时方案，下次部署可能会被覆盖，最好还是优先等官方修复。

• 查看官方社区反馈
  去OpenNext的代码仓库搜类似的报错，可能已经有用户反馈过这个问题，官方可能给出了临时补丁或者明确的解决步骤。

备注：内容来源于stack exchange，提问作者Luke Sharon