能直接用 rewrite_by_lua_block + proxy_pass http://$target_upstream 实现免 reload 路由切换，但必须配合 redis 缓存、共享字典兜底和严格超时控制；核心是通过 map 指令预提取路由键（如 $request_uri → $service_name），lua 中拼接 redis key 查询，超时或失败时 fallback 到 lua_shared_dict 缓存的上一次有效值，并校验 $target_upstream 是否为预定义合法 upstream 名，避免 502。
能直接用 rewrite_by_lua_block + proxy_pass http://$target_upstream 实现免 reload 路由切换，但必须配合 Redis 缓存、共享字典兜底和严格超时控制，否则一查 Redis 慢就拖垮整个 Nginx 进程。
怎么从 URL 或 Header 提取路由键并查 Redis
核心是把请求特征映射成 Redis key，比如 /api/order/create → route:api:order，或 X-Env: staging → route:env:staging。不建议在 Lua 里用字符串分割硬解析路径，容易出错且性能差；优先用 Nginx 的 map 指令预定义规则，再由 Lua 读取变量。
-
map块中提取服务名：map $request_uri $service_name { ~^/user/.* user-api; ~^/order/.* order-api; default default-api; } - 在
access_by_lua_block中拼接 key：local redis_key = "route:" .. ngx.var.service_name - 用
resty.redis查值，注意调用set_timeout(100)（单位毫秒），避免阻塞 - 若 Redis 返回空或超时，不要直接报错，立刻 fallback 到 shared dict 中缓存的上一次有效值
shared dict 缓存怎么设才不翻车
Redis 查询不能每次走网络，但 shared dict 用错会引发内存泄漏或缓存击穿。必须明确：它不是通用缓存，而是 OpenResty 内存中的一块固定区域，所有 worker 共享。
- 在
http块声明：lua_shared_dict route_cache 10m;（10MB 足够存几千条路由） - 写入时带 TTL：
local ok, err = cache:set(key, upstream_addr, 5)（5 秒过期） - 读取时用
cache:get_stale而非get：即使过期也返回旧值，同时触发后台异步刷新 - 禁止往 shared dict 存大对象（如完整 JSON 字符串），只存目标 upstream 名或 IP:Port 字符串
proxy_pass 怎么安全地用变量做上游
proxy_pass http://$target_upstream 看似简单，但 Nginx 不会校验该变量是否对应一个已定义的 upstream 块——如果 Redis 返回了非法值（比如 http://127.0.0.1:9999），Nginx 会直接报 502 Bad Gateway，且无法拦截。
- 必须预定义所有合法 upstream 名，哪怕不填 server：
upstream user-api { } upstream order-api { } - Lua 中只允许返回这些预定义名称，用
if target_upstream ~= "user-api" and target_upstream ~= "order-api" then ngx.exit(400) end校验 - 不要用
ngx.var.upstream_addr手动设地址，那绕过了 Nginx 的健康检查机制 - 如果业务要求直连 IP，改用
balancer_by_lua_block自定义负载均衡器，但需自己实现心跳探测
最易被忽略的是错误传播链：Redis 超时 → shared dict 无 stale 数据 → proxy_pass 变量为空 → 502。这个过程没有任何日志提示根源，只会看到大量 502。务必在每个 Lua 阶段加 ngx.log(ngx.WARN, "redis fail:", err)，并用 lua-resty-prometheus 暴露 consul_route_failures_total 类指标。
