路由文件需按类型差异化缓存:静态路由用强缓存+内容哈希(Cache-Control: public, max-age=31536000, immutable);动态路由用短时效+ETag协商(Cache-Control: private, max-age=300, must-revalidate);HTML入口页应设no-cache或max-age=60,避免阻塞路由更新。

路由文件(如前端框架的 router.js、routes.json,或服务端返回的动态路由配置)通常属于半静态资源:内容不频繁变更,但一旦更新就必须被所有用户立即感知。直接套用长期强缓存或完全禁用缓存都不合适——关键在于“可控更新”。
区分路由文件类型再设策略
不是所有路由文件都一样:
- 构建时生成的静态路由表(如 Vite/Vue Router 的预编译路由配置):内容随版本打包固化,适合强缓存 + 文件哈希;
-
运行时请求的动态路由(如从
/api/routes获取的 JSON):依赖后端权限或状态,需协商验证; -
HTML 入口页中内联的路由逻辑(如
<script type="module"></script>加载的路由模块):本质是 JS 资源,按 JS 缓存规则处理。
静态路由文件:强缓存 + 内容哈希保障更新
这类文件在构建阶段已确定,内容不变则 URL 不变。必须配合构建工具生成带内容哈希的文件名(如 routes.8a3f2d1b.js),然后设置:
Cache-Control: public, max-age=31536000, immutable
其中:
— public 允许 CDN 和浏览器共同缓存;
— max-age=31536000(1年)避免过期检查开销;
— immutable 告诉浏览器:只要 URL 没变,内容绝不会变,连强制刷新也不发请求。
动态路由接口:短时效 + ETag 协商验证
例如请求 /api/user-routes 返回个性化菜单。不能强缓存,但也不该每次全量拉取:
- 响应头设为:Cache-Control: private, max-age=300, must-revalidate(5分钟有效,过期必须验证);
- 服务端为响应体生成稳定
ETag(基于数据内容哈希,而非时间戳); - 浏览器下次请求自动带上
If-None-Match,服务端比对一致即返回304 Not Modified,省去响应体传输。
避免常见陷阱
以下配置看似合理,实则容易引发问题:
- 给路由 JS 文件设
no-cache却没配ETag或Last-Modified→ 每次都回源,失去协商缓存价值; - 用查询参数控制版本(如
routes.js?v=1.2.0)→ 多数 CDN 默认忽略 query string,导致缓存失效; - HTML 页面本身缓存太久(如
max-age=86400)→ 用户看不到新路由入口,即使 JS 已更新也无用;建议 HTML 用no-cache或max-age=60。



















