Nginx rewrite 结合 Lua 实现动态重写的核心机制
通过 nginx 的 ngx_lua 模块,可以在请求处理的早期阶段(如 rewrite_by_lua)执行 lua 脚本,利用 ngx.req.set_uri() 函数动态修改当前请求的 uri,从而实现比传统正则表达式更复杂的逻辑判断。只需在 nginx 配置中加载 ngx_lua 并在 location 块内嵌入 lua 代码,即可根据环境变量、数据库查询或外部 api 返回的结果实时决定跳转目标。

基于用户角色的动态路由重写策略
当需要根据用户身份(如管理员或普通用户)将请求分发到不同后端服务时,可以通过 Lua 解析 Cookie 中的角色标识,并调用 ngx.redirect() 进行即时跳转。这种方案避免了在 Nginx 层编写冗长的条件分支,而是将业务逻辑下沉到 Lua 脚本中处理,提高了配置的灵活性和可维护性。

local role = ngx.var.cookie_role
if role == "admin" then
ngx.redirect("/admin/dashboard", 302)
else
ngx.req.set_uri("/user/home")
end基于时间窗口的灰度发布控制
在灰度发布场景中,可以根据当前时间与预设的时间窗口进行比较,决定是否将流量引导至新版本服务。通过 Lua 获取系统时间并与配置阈值比对,若处于灰度期间则修改 URI 指向测试集群,否则保持原路径,从而实现平滑的版本过渡。

local now = os.time()
if now > 1678886400 and now < 1678972800 then
ngx.req.set_uri("/v2/api/data")
endLua 脚本中 URI 修改对后续处理的影响
在 Lua 脚本中使用 ngx.req.set_uri() 修改 URI 后,Nginx 会重新匹配 location 块,这可能导致请求进入不同的处理流程。如果新 URI 匹配到了另一个包含 proxy_pass 的 location,请求将被转发至对应的 upstream 服务器;若未匹配到任何 location,则可能返回 404 错误。因此,必须确保重写后的 URI 能够被正确的 location 块捕获,避免循环重写或路由丢失。


















