1. 网关基础概念
1.1 什么是 API 网关
API 网关（API Gateway）是微服务架构中所有客户端请求的单一入口点。它位于客户端与后端服务之间，负责请求路由、协议转换、流量控制和安全管理。在分布式系统中，网关充当“反向代理”的角色，但功能远超传统代理——它集成了服务发现、负载均衡、熔断降级、日志审计等能力，是微服务边界的核心组件。
核心定义：API 网关是一个位于客户端与后端服务之间的中间层服务，它封装了系统内部架构，为客户端提供统一的 API 接口，同时承担横切关注点（Cross-Cutting Concerns）的集中处理。
1.2 网关的核心功能
API 网关并非简单的反向代理，它集成了微服务架构中多个关键横切关注点。下表列出网关的三大核心功能及其详细说明：
| 核心功能 | 功能描述 | 典型实现机制 | 故障影响 |
|---|---|---|---|
| 路由 | 根据请求路径、Header、参数将请求转发到对应的后端服务实例 | 服务发现 + 负载均衡算法（轮询、一致性哈希、最小连接数） | 路由错误导致请求 404 或转发到错误服务 |
| 限流 | 控制单位时间内允许通过的请求数量，保护后端服务不被突发流量冲垮 | 令牌桶、漏桶、滑动窗口、计数器（本地 / 分布式限流） | 限流过严导致正常请求被拒；限流失效导致后端过载 |
| 鉴权 | 验证请求身份合法性，确认调用方是否有权限访问目标资源 | JWT 校验、OAuth2 验证、、RBAC 权限检查 | 鉴权绕过导致安全漏洞；鉴权过严导致合法请求被拦截 |
实战提示：在根因定位场景中，路由、限流、鉴权是三大高频故障点。超过 70% 的网关故障可归因于这三类功能的配置错误或组件异常。后续章节将逐一深入分析每种故障的定位方法。
1.3 网关在微服务架构中的位置
在典型的微服务架构中，网关位于客户端与后端服务集群之间，是南北向流量（客户端到服务端）的唯一入口。它与注册中心、配置中心、监控系统等基础设施紧密协作，形成完整的服务治理体系。
网关在架构中的关键职责包括：
- 请求入口统一：所有外部请求首先到达网关，由网关决定转发到哪个服务实例。
- 协议转换：将外部 HTTP/HTTPS 请求转换为内部 RPC（如 gRPC、Dubbo）或消息协议。
- 安全隔离：在网关层完成身份认证、IP 黑白名单、防 SQL 注入等安全过滤，避免安全风险进入内网。
- 流量治理：在网关层实施限流、熔断、重试、超时控制，保障后端服务稳定性。
- 观测接入：在网关层统一采集请求日志、链路追踪数据、监控指标，为根因定位提供数据基础。
根因定位关键点：网关的故障往往不是孤立的。例如，路由失败可能是注册中心服务列表未更新导致，限流异常可能是配置中心规则下发延迟造成。在定位网关根因时，必须同时检查周边基础设施的健康状态。
1.4 网关在微服务架构中的价值总结
API 网关不是可选的“装饰组件”，而是微服务架构中不可或缺的治理枢纽。它带来的核心价值包括：
- 客户端简化：客户端只需与一个端点通信，无需感知后端服务拆分细节。
- 横切关注点集中：鉴权、限流、日志、监控等逻辑在网关层统一实现，避免每个服务重复开发。
- 安全边界：网关作为第一道防线，过滤恶意请求，保护内部服务网络。
- 弹性治理：通过熔断、重试、超时控制，提升系统整体可用性。
- 可观测性：网关是流量观测的最佳位置，所有请求的延迟、状态码、错误信息在此汇聚。
课程前置认知：理解网关的基础概念、核心功能和架构位置，是后续学习根因定位的前提。在接下来的章节中，我们将基于这些基础知识，深入分析路由异常、限流失效、鉴权绕过等典型故障场景的根因定位方法。