Apache APISIX 能够实现 动态修改路由（Dynamic Routing） 的核心原理，是它将传统的静态 Nginx 配置彻底解耦，通过 中心化配置存储（如 etcd） + OpenResty 动态加载机制 + 高效的变更监听与热更新 来实现路由的实时增删改查，而无需重启服务或 reload Nginx。

APISIX 动态修改路由的核心原理

1. 配置与运行时分离：路由信息外置

APISIX 不将路由（Route）、上游（Upstream）、插件（Plugin）等配置写入 nginx.conf，而是将其存储在外部动态存储系统中，默认是 etcd。

• 传统 Nginx：路由写在 nginx.conf 中，修改后需 nginx -s reload 重新加载配置。
• APISIX：路由配置存于 etcd，Nginx 运行时从 etcd 动态获取。

// etcd 中存储的路由示例
{
"uri": "/api/users/*",
"upstream": {
"type": "roundrobin",
"nodes": {
"192.168.1.10:8080": 1
}
},
"plugins": {
"limit-req": { "rate": 100, "burst": 50 }
}
}

2. 基于 etcd 的 Watch 机制实时监听变更

APISIX 的每个 Nginx Worker 进程都会通过 HTTP Long Polling 或 gRPC Watch 机制监听 etcd 中配置的变化。

• 通过 APISIX Admin API 创建、更新或删除一条路由时：

curl http://apisix-admin:9180/apisix/admin/routes/1 \
-X PUT -d '{
"uri": "/hello",
"upstream": { "nodes": {"127.0.0.1:8080":1} }
}'
etcd 会触发一个 watch 事件。

• APISIX 的 core/config 模块监听到该事件，立即更新内存中的路由表。

无需 reload：配置变更直接生效，毫秒级延迟，无连接中断。

3. 内存中维护路由索引表（Radix Tree）

APISIX 使用 Radix Tree（基数树） 数据结构在内存中高效存储和匹配路由。

• 支持前缀匹配、通配符（*）、正则匹配。
• 查找时间复杂度接近 O(m)，m 为 URI 长度，非常高效。
• 路由变更时，APISIX 只需更新 Radix Tree 中的节点，不影响其他路由。

-- 内存中的路由表结构（简化）
routes = {
radix: {
"/api/users/*" -> route_id_1,
"/hello" -> route_id_2,
"/blog/\\d+" -> route_id_3 -- 正则
}
}

4. OpenResty 的 Lua 协程支持动态加载

APISIX 基于 OpenResty（Nginx + LuaJIT），利用 Lua 的动态特性：

• 在 rewrite 阶段，通过 Lua 代码从内存中查询最新的路由表。
• 每次请求到达时，都使用当前最新的路由配置进行匹配。
• 插件、上游、重写规则等也动态加载，无需重启。

-- 伪代码：APISIX 在 rewrite 阶段匹配路由
function match_route(uri)
local route = radix_tree.match(uri)
if route then
ngx.ctx.route = route
apply_plugins(route.plugins) -- 动态加载插件
end
end

5. 多节点一致性：所有实例同步更新

在集群环境下，多个 APISIX 实例都连接到同一个 etcd 集群：

• 当一个实例更新路由，etcd 保证数据一致性。
• 所有 APISIX 实例几乎同时收到变更通知，同步更新本地内存中的路由表。
• 实现全局路由一致，支持横向扩展。

动态路由的优势

典型应用场景

API 灰度发布：

// 动态将 10% 流量导向新版本
"vars": [["http_version", "==", "beta"]]

服务降级：

• 动态将 /pay 路由指向降级页面或 mock 服务。

安全应急：

• 立即添加 uri-blocker 插件阻断攻击路径。

A/B 测试：

• 动态分流不同用户到不同 upstream。

总结

APISIX 实现动态修改路由的核心原理是：

“配置外置 + etcd 监听 + 内存热更新 + Radix Tree 高效匹配”

它打破了传统 Nginx 的静态配置模式，利用 OpenResty 的 Lua 动态能力，在 Nginx 的 rewrite 阶段实时读取最新的路由规则，实现了无需 reload 的毫秒级动态路由变更，是云原生 API 网关的关键能力。