NNext.js 中文网 GitHub

outputHashSalt

了解如何将自定义盐值字符串纳入按内容寻址的输出文件名。

outputHashSalt 是一个选项,可将可配置的盐值字符串纳入每个按内容寻址的输出文件名(chunk、资源)。更改此值会强制所有输出哈希发生变化,这对于在不修改源文件的情况下跨部署使缓存资源失效很有用。

要配置输出哈希盐值,请在 next.config.js 中设置 outputHashSalt:

next.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
  outputHashSalt: 'my-deployment-salt',
}

module.exports = nextConfig

这适用于 Webpack 和 Turbopack 打包器。

也可以使用 NEXT_HASH_SALT 环境变量达到同样的目的。当两者都设置时,这些值会被拼接(outputHashSalt + NEXT_HASH_SALT)以形成有效的盐值。这使你能够将写入配置的按项目盐值与通过环境变量在构建时注入的按部署盐值结合起来。

Terminal
NEXT_HASH_SALT=my-deployment-salt next build

版本历史#

版本变更
16.3.0新增 outputHashSalt。
Next.js 中文网