fix: 静态资源 URL 加版本号，避免浏览器缓存旧 404 导致持续白屏 #3

2026-08-18T18:25:06+08:00

dsh commented

2026-08-18 18:25:06 +08:00

背景

PR #2 部署后服务器端已修复（/static 由二进制内嵌提供，实测全站 0 个 404），但部分用户浏览器仍显示异常：静态资源响应带 Cache-Control: max-age=14400，浏览器把修复前的旧 404 响应缓存了下来，继续使用旧页面/旧资源。

修复

markdown_assets 模板中本地静态资源 URL 增加版本参数：/static/js/markdown.js?v=2、/static/css/markdown.css?v=2。URL 变化后浏览器必然重新请求，旧缓存自动失效。以后每次改动 static 文件，把 ?v= 递增即可。

验证

go build / go vet 通过
页面输出包含 ?v=2，带查询串请求 /static/* 仍返回 200（Gin 静态服务忽略 query string）

## 背景 PR #2 部署后服务器端已修复（/static 由二进制内嵌提供，实测全站 0 个 404），但部分用户浏览器仍显示异常：静态资源响应带 `Cache-Control: max-age=14400`，浏览器把修复前的旧 404 响应缓存了下来，继续使用旧页面/旧资源。 ## 修复 `markdown_assets` 模板中本地静态资源 URL 增加版本参数：`/static/js/markdown.js?v=2`、`/static/css/markdown.css?v=2`。URL 变化后浏览器必然重新请求，旧缓存自动失效。以后每次改动 static 文件，把 `?v=` 递增即可。 ## 验证 - `go build` / `go vet` 通过 - 页面输出包含 `?v=2`，带查询串请求 `/static/*` 仍返回 200（Gin 静态服务忽略 query string）

dsh added 1 commit 2026-08-18 18:25:06 +08:00

fix: cache-bust static asset URLs (?v=2) c5218f35a1

Browsers cached the pre-fix 404 responses for /static/js/markdown.js and
/static/css/markdown.css (responses carry Cache-Control max-age=14400),
so users kept seeing broken pages after redeploy. A versioned query
string forces clients to refetch the assets; bump ?v= whenever the
static files change.

kevin merged commit c3f8be58c9 into main

2026-08-18 18:25:32 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: kevin/go_blog#3

Allow edits from maintainers