现代微服务 API 网关完全指南 2026：Apache APISIX vs Envoy vs Kong 选型 + 动态路由 + 插件实战

在分布式微服务架构中，API 网关（API Gateway） 处于整座系统架构的最前端，是所有外部流量进出的咽喉要道。

它承担着动态路由寻址、协议转换（HTTP 转 gRPC）、统一鉴权认证（JWT/OAuth2）、全链路安全防刷限流、灰度金丝雀分流与分布式链路追踪等关键职责。传统的静态 nginx.conf 频繁 reload 已无法适应现代微服务的高频发布诉求。

本文遵循 EEAT 架构专家标准，深度横评 2026 年三大主流网关（Apache APISIX vs Envoy vs Kong），并以 Apache APISIX 为实战基准，全面拆解动态路由、插件开发与生产高可用落地。

架构对比：三大主流 API 网关全维度选型矩阵#

维度	Apache APISIX 3.x+	Envoy Proxy (1.30+)	Kong Gateway 3.x+	传统 Nginx 反代
核心开发语言	Nginx C + LuaJIT	纯 C++	OpenResty C + Lua	纯 C 语言
控制面存储	🥇 etcd (分布式共识)	xDS (动态 gRPC 控制面)	PostgreSQL / DB-less YAML	本地静态配置文件
路由匹配算法	🥇 Radix Tree (基数树，O(K)复杂度)	Trie 树 / 正则匹配	正则与前缀逐条匹配	逐条 Location 匹配
配置热更新机制	🥇 Zero-Reload (毫秒级 etcd Watch)	🥇 Zero-Reload (xDS 流式推送)	毫秒级 (依赖轮询/DB-less)	❌ 必须 `nginx -s reload` (断连接)
插件多语言支持	🥇 Lua, Wasm, Go, Python, Java	C++, Wasm	Lua, Go, JavaScript	仅支持 C 模块 / NGINX Lua
单机并发吞吐量	🥇 极高 (15万~25万 QPS)	🥇 极高 (15万~20万 QPS)	⭐⭐⭐⭐ (10万~15万 QPS)	极高 (但无业务动态能力)
Kubernetes 网关集成	APISIX Ingress Controller	🥇 Envoy Gateway (标准 Gateway API)	Kong Ingress Controller	Ingress-Nginx
生产最佳适用场景	企业统一业务 API 网关、多租户中台	Service Mesh 服务网格数据面、云原生网关	经典老牌系统迁移、海外 SaaS 生态集成	纯静态资源托管、简单四层端口转发

一、API 网关在微服务全栈中的核心定位#

1
                      [ 客户端: Web / iOS / Android / 开放平台 API ]
2
                                            │ HTTPS / WSS
3
                                            ▼
4
                    ┌──────────────────────────────────────────────┐
5
                    │    Apache APISIX API Gateway (统一接入层)    │
6
                    │  - SSL 卸载 / SNI 动态证书                   │
7
                    │  - JWT / OIDC / API Key 统一鉴权              │
8
                    │  - 限流熔断 (Limit-Req / Circuit-Breaker)     │
9
                    │  - 动态金丝雀灰度发布 (Traffic Split)         │
10
                    │  - OpenTelemetry / Prometheus 自动可观测     │
11
                    └───────────────────────┬──────────────────────┘
12
                                            │ 毫秒级动态路由分发
13
                    ┌───────────────────────┴───────────────────────┐
14
                    │ gRPC (Protobuf)                               │ HTTP REST
15
                    ▼                                               ▼
16
     ┌─────────────────────────────┐                 ┌─────────────────────────────┐
17
     │   User Microservice (Go)    │                 │   Order Microservice (Rust) │
18
     │  - gRPC Server (:50051)     │                 │  - Axum HTTP Server (:8080) │
19
     └──────────────┬──────────────┘                 └──────────────┬──────────────┘
20
                    │                                               │
21
                    └───────────────────────┬───────────────────────┘
22
                                            ▼
23
                             [ 数据存储: PostgreSQL / Redis ]

二、Docker Compose 生产级部署 APISIX + etcd + Dashboard#

1
services:
2
  # ── 1. etcd 配置共识中枢 ─────────────────────────────────────
3
  etcd:
4
    image: bitnami/etcd:3.5.14
5
    container_name: apisix-etcd
6
    restart: unless-stopped
7
    environment:
8
      - ALLOW_NONE_AUTHENTICATION=yes
9
      - ETCD_ADVERTISE_CLIENT_URLS=http://etcd:2379
10
      - ETCD_LISTEN_CLIENT_URLS=http://0.0.0.0:2379
11
    volumes:
12
      - etcd_data:/bitnami/etcd
13
    ports:
14
      - "2379:2379"
15
    networks:
16
      - apisix-net
17

18
  # ── 2. Apache APISIX 网关数据面 ──────────────────────────────
19
  apisix:
20
    image: apache/apisix:3.9.1-debian
21
    container_name: apisix-server
22
    restart: unless-stopped
23
    volumes:
24
      - ./apisix_conf/config.yaml:/usr/local/apisix/conf/config.yaml:ro
25
    ports:
26
      - "80:9080" # 外部 HTTP 流量入口
27
      - "443:9443" # 外部 HTTPS 流量入口
28
      - "9180:9180" # Admin API 控制面管理端口 (必须内网隔离!)
29
      - "9091:9091" # Prometheus Metrics 监控指标端口
30
    networks:
31
      - apisix-net
32
    depends_on:
33
      - etcd
34

35
  # ── 3. APISIX Dashboard 可视化管理控制台 ─────────────────────
36
  apisix-dashboard:
37
    image: apache/apisix-dashboard:3.0.1-alpine
38
    container_name: apisix-dashboard
39
    restart: unless-stopped
40
    volumes:
41
      - ./dashboard_conf/conf.yaml:/usr/local/apisix-dashboard/conf/conf.yaml:ro
42
    ports:
43
      - "9000:9000" # 控制台访问端口
44
    networks:
45
      - apisix-net
46
    depends_on:
47
      - apisix
48

49
volumes:
50
  etcd_data:
51

52
networks:
53
  apisix-net:
54
    driver: bridge

三、APISIX 动态路由与核心功能实战（Admin API）#

所有配置通过 REST API 直接与 etcd 交互，完全无需 Reload 即可在全网关节点毫秒级生效。

3.1 创建高可用负载均衡上游（Upstream）#

1
curl "http://127.0.0.1:9180/apisix/admin/upstreams/1" \
2
  -H "X-API-KEY: edd1c9f034335f136f87ad84b625c8f1" \
3
  -X PUT -d '{
4
    "type": "roundrobin",
5
    "name": "user-service-cluster",
6
    "nodes": {
7
      "192.168.1.50:8080": 80,
8
      "192.168.1.51:8080": 20
9
    },
10
    "checks": {
11
      "active": {
12
        "http_path": "/health",
13
        "healthy": { "interval": 2, "successes": 1 },
14
        "unhealthy": { "interval": 1, "http_failures": 2 }
15
      }
16
    }
17
  }'

3.2 创建包含 JWT 鉴权与精准限流的路由（Route）#

1
curl "http://127.0.0.1:9180/apisix/admin/routes/100" \
2
  -H "X-API-KEY: edd1c9f034335f136f87ad84b625c8f1" \
3
  -X PUT -d '{
4
    "uri": "/api/v1/orders/*",
5
    "name": "order-api-route",
6
    "methods": ["GET", "POST", "PUT"],
7
    "upstream_id": "1",
8
    "plugins": {
9
      "jwt-auth": {},
10
      "limit-req": {
11
        "rate": 100,
12
        "burst": 50,
13
        "key_type": "var",
14
        "key": "consumer_name",
15
        "rejected_code": 429
16
      },
17
      "prometheus": {
18
        "prefer_name": true
19
      },
20
      "opentelemetry": {
21
        "sampler": { "name": "always_on" }
22
      }
23
    }
24
  }'

3.3 金丝雀灰度发布实战（Traffic Split 按比例分流）#

在不中断线上服务的情况下，将 10% 流量无缝切往新版 v2 服务，验证无误后逐步平滑提升至 100%：

1
curl "http://127.0.0.1:9180/apisix/admin/routes/101" \
2
  -H "X-API-KEY: edd1c9f034335f136f87ad84b625c8f1" \
3
  -X PUT -d '{
4
    "uri": "/api/v1/payment/*",
5
    "name": "canary-payment-route",
6
    "plugins": {
7
      "traffic-split": {
8
        "rules": [
9
          {
10
            "weighted_upstreams": [
11
              {
12
                "upstream_id": "1",
13
                "weight": 90
14
              },
15
              {
16
                "upstream": {
17
                  "name": "payment-v2-canary",
18
                  "type": "roundrobin",
19
                  "nodes": { "192.168.1.60:8080": 1 }
20
                },
21
                "weight": 10
22
              }
23
            ]
24
          }
25
        ]
26
      }
27
    }
28
  }'

四、自定义插件开发实战（Lua 极速插件）#

当内置 100+ 插件无法满足特定的企业私有协议验证时，可以在 5 分钟内编写一个高性能自定义插件：

1
-- /usr/local/apisix/apisix/plugins/tenant-auth.lua
2
local core = require("apisix.core")
3
local plugin_name = "tenant-auth"
4

5
local schema = {
6
    type = "object",
7
    properties = {
8
        header_key = { type = "string", default = "X-Tenant-ID" }
9
    },
10
    required = { "header_key" }
11
}
12

13
local _M = {
14
    version = 0.1,
15
    priority = 2500, -- 优先级高于普通业务插件
16
    name = plugin_name,
17
    schema = schema
18
}
19

20
function _M.check_schema(conf)
21
    return core.schema.check(schema, conf)
22
end
23

24
-- 在请求进入上游前的 access 阶段执行校验
25
function _M.access(conf, ctx)
26
    local tenant_id = core.request.header(ctx, conf.header_key)
27

28
    if not tenant_id or tenant_id == "" then
29
        core.log.warn("Missing tenant header: ", conf.header_key)
30
        return 401, { message = "Unauthorized: Missing Tenant Header" }
31
    end
32

33
    -- 将租户 ID 注入上游请求头与 OpenTelemetry 上下文中
34
    core.request.set_header(ctx, "X-Internal-Tenant", tenant_id)
35
end
36

37
return _M

五、生产环境高可用与性能调优黄金法则#

etcd 高可用集群构建：
- 生产环境严禁使用单节点 etcd，必须部署至少 3 节点分布式 etcd 集群，并配置独立 SSD 磁盘保证低写延迟（<10ms）。

连接池复用与 Keepalive 调优：

1
nginx_config:
2
  http:
3
    keepalive_timeout: 60s
4
    keepalive_requests: 10000

隔离控制面 Admin API：
- Admin API（端口 9180）绝对禁止向公网开放，必须绑定内网 IP 或通过安全组/VPN 进行严格访问限制。

相关文章：

本文基于 Apache APISIX 3.9+、Envoy 1.30+ 及 etcd 3.5+ 编写。对于追求极致低延迟与动态可扩展性的微服务架构，Apache APISIX 是目前国内云原生落地的首选方案之一。