outputHashSalt

Core Idea

Incorpora uma string de salt configurável nos nomes de arquivo de output com hash de conteúdo (chunks, assets), permitindo invalidar cache de assets entre deployments sem tocar no código-fonte.

Key Concepts

• outputHashSalt (config): string aplicada a todo filename com content hash. Mudar o valor força todos os hashes a mudarem.
• NEXT_HASH_SALT (env var): mesmo propósito, aplicável em build time.
• Quando ambos definidos, os valores são concatenados (outputHashSalt + NEXT_HASH_SALT), permitindo combinar um salt fixo por projeto com um salt por deployment injetado via env.
• Funciona tanto com Webpack quanto Turbopack.

Code Examples

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

NEXT_HASH_SALT=my-deployment-salt next build

• O que demonstra: salt fixo no config vs. salt injetado em build time via env var.

Version History

Versão	Mudança
16.3.0	outputHashSalt adicionado.