Nginx静态资源容灾路由核心是通过try_files+error_page实现多级兜底，或upstream+proxy_next_upstream自动重试，辅以URL参数动态路由；需注意alias/root区别、proxy_pass尾部斜杠、error_page的=符号及upstream健康参数配置。
Nginx 实现静态资源请求的容灾路由，核心是让一次请求在主路径失败时，能自动、无感地切换到备用路径（如备用源站、本地磁盘、降级资源），不依赖外部健康检查，全靠 Nginx 内置指令协同完成。
用 try_files + error_page 实现多级兜底
这是最轻量、最可控的方式，适合静态资源（如 `/static/js/app.js`）按优先级逐层 fallback： - 第一级：尝试本地磁盘缓存（最快，零网络开销） - 第二级：回源到主静态服务器 - 第三级：回源到备用静态服务器 - 第四级：返回统一降级 HTML 或空响应示例配置：
location /static/ {
# 1. 先查本地磁盘（/data/static/ 对应 /static/ 路径）
alias /data/static/;
try_files $uri @primary;
<pre class='brush:php;toolbar:false;'># 2. 本地没命中，走主源（带错误捕获）
location @primary {
proxy_pass http://origin-primary;
proxy_set_header Host $host;
proxy_intercept_errors on;
error_page 502 503 504 = @backup;
}
# 3. 主源失败，切到备用源
location @backup {
proxy_pass http://origin-backup;
proxy_set_header Host $host;
proxy_intercept_errors on;
error_page 502 503 504 = @degrade;
}
# 4. 备用源也失败，返回降级资源（可为本地文件或内嵌响应）
location @degrade {
# 方式一：返回本地降级页
alias /data/degrade/;
try_files /404.html =404;
# 方式二：直接返回空响应（适合图片/js/css等）
# return 204;
}}
用 upstream + proxy_next_upstream 做主备自动重试
适合主备源域名相同、端口一致，且希望由 Nginx 自动探测并重试的场景（例如两台结构相同的静态源站）： - 不需要显式写多个 location，逻辑更简洁 - 但要求主备服务协议、路径完全兼容（否则重试可能 404）关键点：
- 在 upstream 中定义主、备 server，不加 backup 标记（避免仅在主全挂时才启用，我们要的是“单次失败即切换”）
- 用 proxy_next_upstream 明确指定哪些状态码触发重试（如 502/503/timeout）
- 配合 proxy_next_upstream_tries 和 proxy_next_upstream_timeout 控制重试行为，防止卡顿
示例：
upstream static_origin {
server origin-primary.example.com:80 max_fails=1 fail_timeout=10s;
server origin-backup.example.com:80 max_fails=1 fail_timeout=10s;
}
<p>server {
location /static/ {
proxy_pass <a href="https://www.php.cn/link/20540c599746e70d0787f05c42f002bb">https://www.php.cn/link/20540c599746e70d0787f05c42f002bb</a>;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;</p><pre class='brush:php;toolbar:false;'> proxy_next_upstream error timeout http_500 http_502 http_503 http_504;
proxy_next_upstream_tries 2;
proxy_next_upstream_timeout 5s;
}}
结合 URL 参数做动态路由（按需容灾）
某些场景下，你希望部分请求强制走备用链路（比如灰度发布、AB 测试、或某类资源已知主源不稳定）： - 利用 $arg_xxx 获取 URL 参数（如?fallback=1）
- 用 if 判断跳转，或直接改写 proxy_pass 目标
示例（带 fallback 参数则直连备用源）：
location /static/ {
if ($args ~* "fallback=1") {
proxy_pass http://origin-backup;
break;
}
proxy_pass http://origin-primary;
proxy_set_header Host $host;
}
⚠️ 注意：if 在 location 中慎用，仅限简单变量判断；复杂逻辑建议用 map 指令预定义变量。
关键细节不能漏
- alias 和 root 区分清楚：alias 会替换整个 location 路径，root 是拼接路径；静态资源用 alias 更安全
- 每个 proxy_pass 后不要加 /（除非你明确要 strip 掉前缀），否则路径可能错位
- error_page 的 = 符号必须写，否则会触发内部重定向而非状态码透传
- 所有 upstream server 都要设 max_fails 和 fail_timeout，避免单次超时就踢出节点
- 测试时用 curl -v 加 -H 'Host: xxx' 模拟真实请求头，避免因 Host 不匹配被源站拒绝
容灾不是堆备机，而是让每次请求都有清晰的逃生路径。用好 try_files、error_page、proxy_next_upstream 这三个指令组合，就能在不引入额外组件的前提下，把静态资源的可用性稳稳托住。
