静态资源服务平滑路由切换可通过nginx实现：①rewrite+try_files完成路径映射与兜底；②error_page+upstream实现多源容灾降级；③map+root支持环境级动态路由；④配合日志与缓存策略保障可观测与收敛验证。
静态资源服务的平滑路由切换，核心是请求不中断、URL 不暴露变更、前端无需修改，同时支持渐进验证与快速回退。Nginx 本身不依赖外部组件，靠 rewrite、try_files、error_page 和 location 分层协作就能完成。
用 rewrite + try_files 实现路径映射与兜底
这是最常用也最轻量的方式，适用于版本目录迁移（如 /static/v1/ → /assets/）或构建路径调整（如 /dist/js/ → /js/）。
- 在匹配旧路径的 location 块中，用 rewrite ... last 把请求内部重写到新路径，避免 302 跳转
- 紧接着用 try_files 检查新路径是否存在：命中则直接返回；未命中则按顺序尝试其他路径或返回 404
- 例如将 /static/v1/js/app.js 映射到 /assets/js/app.js，配置如下：
location /static/v1/ {
rewrite ^/static/v1/(.*)$ /assets/$1 last;
}
location /assets/ {
root /data/www;
try_files $uri =404;
}
通过 error_page + upstream 实现多源容灾切换
当静态资源分布在多个后端（如主 CDN、备用源站、本地缓存）时，可用 error_page 触发逐级降级，整个过程对客户端透明。
- 第一级优先查本地磁盘（最快），失败后 proxy_pass 到主源站
- 主源站返回 502/503/504 时，由 error_page 捕获并跳转到 @backup 位置
- @backup 再试备用源，仍失败则进入 @degrade 返回降级资源（如空响应或默认占位图）
- 注意 proxy_intercept_errors 必须开启，否则错误码不会被 error_page 捕获
借助 map + root 实现环境级动态路由
若需按域名、请求头或 URL 参数区分资源来源（如 test.example.com 用测试版，prod.example.com 用正式版），不建议直接在 root 中写变量，而应结合 map 指令预定义路径变量。
- 先用 map 根据 $host 或 $arg_env 定义变量 $static_root，例如：
map $host $static_root {
test.example.com "/data/static-test";
default "/data/static-prod";
} - 再在 location 中使用 root $static_root；这样既安全又可读，避免 root 指令不支持变量嵌套的问题
- 配合 expires 或 Cache-Control 策略，确保不同环境的缓存行为可控
配合日志与缓存策略辅助收敛验证
平滑切换不是一次性操作，而是需要可观测、可度量的过程。
- 在 rewrite 或 proxy_pass 的 location 中添加自定义日志，记录原始 URI 与最终命中路径，用于统计旧路径调用量下降趋势
- 对 HTML 文件禁用长期缓存（add_header Cache-Control "no-cache, must-revalidate"），确保每次访问都走 Nginx，便于统一控制资源版本
- 对 JS/CSS 等静态资源启用 immutable 缓存（add_header Cache-Control "public, immutable"），防止带 hash 的 URL 被重复请求
