Nginx 通过 try_files $uri @fallback 实现多级高可用容错，按序检查静态资源，失败后内部重定向至命名 location；@fallback 可嵌套 try_files 或 proxy_pass 实现二级降级，结合 lua 模块可扩展为三级智能路由。
通过 try_files $uri @fallback 实现多级高可用路径容错，核心在于利用 Nginx 的请求路径匹配与内部重定向机制，构建“逐层降级、自动兜底”的服务链路。它不是简单地 fallback 一次，而是通过嵌套命名 location、配合变量控制或外部模块（如 lua），实现多级试探与策略路由。
理解 try_files 的执行逻辑
try_files 按空格分隔的顺序依次检查每个参数是否对应真实存在的文件或目录：
-
$uri：当前请求 URI 对应的静态资源路径（如/api/v2/user→ 查找/var/www/api/v2/user） - 若全部失败，则跳转到末尾的命名 location（如
@fallback），且该跳转是内部重定向，不改变客户端 URL - 关键点：
@fallback内可再次使用try_files，形成第二级试探；也可代理到其他 upstream，或触发 lua 脚本做动态决策
构建两级容错：静态 → API 网关 → 备用集群
典型场景：前端静态资源缺失时，先交由本地 API 服务处理；API 也无响应时，再转发至灾备集群。
location / {
try_files $uri @api;
}
<p>location @api {</p><h1>尝试将请求交给本地 API（如后端 Node.js）</h1><pre class="brush:php;toolbar:false;">proxy_pass http://localhost:3000;
proxy_intercept_errors on;
error_page 502 503 504 @standby;}
location @standby {
降级到异地备用集群
proxy_pass https://backup-api.example.com; proxy_set_header Host backup-api.example.com;
}
注意：proxy_intercept_errors on 是启用 error_page 跳转的前提，否则 5xx 不会触发 @standby。
实现三级容错：加一层 Lua 动态路由
当需要基于请求头、参数、健康状态等做智能降级时，纯配置难以满足。可结合 ngx_http_lua_module：
- 第一级：
try_files $uri @lua_fallback - 在
@lua_fallback中用content_by_lua_block查询 Consul 健康检查结果 - 若主服务健康，proxy_pass 到主集群；否则尝试次优节点；最后 fallback 到缓存响应或默认页
示例片段：
location @lua_fallback {
content_by_lua_block {
local upstreams = { "main", "backup", "cache" }
for _, u in ipairs(upstreams) do
local ok, res = ngx.location.capture("/_health/" .. u)
if ok == 200 then
ngx.exec("@proxy_" .. u)
return
end
end
ngx.exec("@default_page")
}
}避免常见陷阱
-
不要在 try_files 后直接写 proxy_pass：Nginx 不允许在
try_files后面混用代理指令，必须用命名 location 隔离 -
@fallback 中不能再用 try_files $uri ……：因为
$uri未重置，仍为原始值，容易循环；应改用$request_uri或自定义变量 - 多级 fallback 建议加日志标识，例如
log_format main '$remote_addr – $uri → $upstream_addr [$status]';，便于追踪降级路径 - 静态文件路径需确保权限正确，否则
try_files会因 permission denied 视为“不存在”，误入 fallback
