NNext.js 中文网 GitHub

generateBuildId

配置构建 ID,用于标识当前正在为你的应用程序提供服务的构建版本。

Next.js 在 next build 期间生成一个 ID,用于标识正在为你的应用程序提供服务的版本。同一个构建应当被用于并启动多个容器。

如果你要为环境的每个阶段分别重新构建,则需要生成一个一致的构建 ID 供各容器之间使用。在 next.config.js 中使用 generateBuildId 命令:

next.config.js
module.exports = {
  generateBuildId: async () => {
    // 这可以是任何内容,这里使用最新的 git hash
    return process.env.GIT_HASH
  },
}

小知识: 当设置了 deploymentId 后,除非你显式配置 generateBuildId,否则 Next.js 会使用固定的构建 ID。版本偏移(Version skew)会改为从部署 ID 检测。