Edge 运行时 (Edge Runtime)

Next.js 提供了两种可在应用程序中使用的服务端运行时：

• Node.js 运行时（默认），可访问所有 Node.js API，用于渲染您的应用程序。
• Edge Runtime，包含一组更有限的 API，用于 中间件。

注意事项

• Edge Runtime 不支持所有 Node.js API。某些包可能无法按预期工作。
• Edge Runtime 不支持增量静态再生 (ISR)。
• 根据您的部署适配器，两种运行时均可支持 流式传输。

参考

Edge Runtime 支持以下 API：

网络 API

编码 API

流 API

加密 API

Web 标准 API

Next.js 专属 Polyfills

• AsyncLocalStorage

环境变量

你可以使用 process.env 来访问环境变量，无论是在 next dev 还是 next build 模式下。

不受支持的 API

Edge 运行时存在一些限制，包括：

• 不支持原生 Node.js API。例如，无法读写文件系统。
• 可以使用 node_modules，只要它们实现了 ES 模块且未使用原生 Node.js API。
• 不允许直接调用 require。请改用 ES 模块。

以下 JavaScript 语言特性被禁用，将无法工作：

在极少数情况下，你的代码可能包含（或导入）一些动态代码评估语句，这些语句在运行时无法被访问且无法通过 treeshaking 移除。
你可以通过中间件配置放宽检查，允许特定文件：

export const config = {
  unstable_allowDynamic: [
    // 允许单个文件
    '/lib/utilities.js',
    // 使用 glob 模式允许第三方模块 function-bind 中的所有内容
    '**/node_modules/function-bind/**',
  ],
}

unstable_allowDynamic 是一个 glob 或 glob 数组，用于忽略特定文件的动态代码评估检查。这些 glob 路径相对于应用程序的根目录。

请注意，如果这些语句在 Edge 环境中执行，它们会抛出错误并导致运行时故障。