Next.js 13 SSG：如何强制浏览器获取最新静态资源（含index.txt）

1. 如何在SSG构建时为所有文件（包括.txt）应用新版本号？ #

Next.js 默认仅对 _next/static 目录下的资源自动添加哈希后缀，自定义 generateBuildId() 也仅作用于该目录。要给自定义的 .txt 文件等非Next.js托管静态资源加版本号，可通过两种方式实现：

• 注入构建ID到环境变量：在 next.config.js 中定义稳定的 generateBuildId（比如基于Git Commit Hash或时间戳），然后在构建命令中将其注入为环境变量（例如 package.json 的 build 脚本改为 NEXT_PUBLIC_BUILD_ID=$(node -e "require('./next.config.js').generateBuildId()") next build）。之后在页面代码中引用 .txt 文件时，手动拼接版本参数：/path/index.txt?v=${process.env.NEXT_PUBLIC_BUILD_ID}。
• 构建后重命名文件：编写脚本在构建完成后，将所有 .txt 文件重命名为带版本号的格式（如 index.{buildId}.txt），再批量替换所有资源中对该文件的引用路径。这种方式需确保所有引用场景都被覆盖。

2. 如何为资源添加?v={buildId}参数且避免浏览器编码？ #

你之前的脚本使用了 %3F（?的URL编码），导致浏览器请求的路径与存储的实际文件名不匹配，引发404。正确做法是直接使用未编码的 ?，修改脚本如下：

# 获取自定义的buildId（如果next.config.js里有generateBuildId）
BUILD_ID=$(node -e "require('./next.config.js').generateBuildId()")
# 替换所有index.txt引用为带版本参数的格式
find out -type f -exec grep -q "index.txt" {} \; -exec sed -i '' -e "s/index.txt/index.txt?v=$BUILD_ID/g" {} \;

大部分对象存储桶（如S3、OSS）会自动忽略URL查询参数，直接返回对应的 index.txt 文件，无需额外配置。

3. 强制浏览器获取最新资源的其他方法 #

除了版本参数，还有这些可行方案：

• 配置缓存策略：在对象存储桶中为关键资源（如 index.txt）设置严格的缓存头，例如 Cache-Control: no-cache, must-revalidate，让浏览器每次请求都验证资源是否更新；或设置较短的TTL（如5分钟），平衡缓存效率与更新及时性。
• 内容哈希重命名：基于文件内容生成唯一哈希，将 index.txt 重命名为 index.{contentHash}.txt，每次文件内容变更时文件名自动更新，浏览器会主动请求新文件。可通过脚本结合哈希工具（如 md5sum）实现这一流程。
• 增量静态再生（ISR）：如果使用App Router，可在页面组件中设置 revalidate 属性，实现页面内容的自动更新，但该机制主要针对页面渲染内容，对独立静态资源需配合上述方法使用。

内容的提问来源于stack exchange，提问作者Ayoub ASRI