实现“一键全站降级”的核心是将决策前置到nginx层，通过map指令定义动态开关变量，结合if或lua读取redis实现秒级生效，并统一拦截、返回预设响应或跳转降级页。
要实现“一键全站降级”，核心不是改后端代码，而是把降级决策提到最前端——Nginx 层。通过一个全局可动态控制的变量（比如从 Redis 读取、或由配置文件/HTTP 头/上游服务注入），让 Nginx 在请求入口就判断是否启用降级策略，从而统一拦截、重写、跳转或返回预设响应。
用 map 指令定义降级开关变量
在 http 块中，用 map 指令将外部信号映射为布尔型变量，这是实现“开关”的轻量可靠方式：
- 支持从请求头（如
X-Global-Downgrade: on）、cookie、URI 参数甚至自定义 Lua 变量取值 - 变量值可实时更新，无需 reload nginx（配合 Lua 或 shared dict 可做到秒级生效）
- 示例：
map $http_x_global_downgrade $is_downgraded {<br> default 0;<br> "on" 1;<br> "true" 1;<br>}
在 server 或 location 中统一拦截与响应
一旦变量可用，即可在关键位置插入逻辑，避免逐个接口重复判断：
- 对非静态资源（如
location /api/、location /user/）添加if ($is_downgraded) { return 200 '{"code":503,"msg":"服务临时维护"}'; } - 对 HTML 页面类请求，可
rewrite ^(.*)$ /downgrade.html break;，指向预置的降级页 - 若需保留部分核心路径（如登录、健康检查），用
if ($is_downgraded) { if ($request_uri !~ ^/(login|healthz|/static)) { ... } }白名单放行
结合 Lua + Redis 实现动态热开关（进阶）
当开关需要集中管理或多实例同步时，推荐用 nginx-lua 读取 Redis 中的降级状态：
- 在
init_by_lua_block初始化 Redis 连接池 - 在
set_by_lua_block或access_by_lua_block中执行redis:get("global:downgrade:flag") - 将结果赋给
$is_downgraded，后续逻辑复用前面 map 方式即可 - 运维只需
SET global:downgrade:flag "1"即刻全站生效，清空即恢复
配套要点：缓存、日志与可观测性
降级不是隐藏问题，而是主动控制体验边界：
- 对降级响应添加特定 Header（如
Server: nginx-downgraded），便于网关或前端识别并展示友好提示 - 开启
log_format记录$is_downgraded字段，方便统计降级触发频次与路径分布 - 所有降级响应建议设置短缓存（
Cache-Control: no-cache, max-age=0），防止 CDN 缓存错误状态 - 静态资源（CSS/JS/图片）通常不参与降级，应单独配置
location ~* \.(js|css|png|jpg|gif)$并跳过判断逻辑
