1. 网关概述：API网关在微服务架构中的核心作用、常见网关对比与课程架构
1.1 为什么微服务架构需要API网关
在单体应用拆分为微服务后，客户端直接调用每个微服务会面临诸多问题：认证鉴权分散、协议转换复杂、请求聚合困难、流量控制缺失。API网关作为系统的统一入口，承担了请求路由、协议适配、安全防护、流量治理等核心职责，是微服务架构中不可或缺的基础设施层。
核心价值：API网关将非业务功能（认证、限流、日志、熔断）从业务服务中剥离，让后端服务专注于业务逻辑，同时为前端提供统一的调用入口，降低客户端与服务端的耦合度。
1.2 API网关的核心作用
| 作用维度 | 具体职责 | 典型场景 |
|---|---|---|
| 请求路由 | 根据请求路径、Header、参数将请求转发到对应后端服务 | /api/user/* → user-service，/api/order/* → order-service |
| 负载均衡 | 将请求分发到同一服务的多个实例，支持轮询、加权、一致性哈希等策略 | user-service 有3个实例，网关按权重分配流量 |
| 认证鉴权 | 统一校验JWT Token、OAuth2、API Key，拦截非法请求 | 所有请求先经过网关校验Token，再转发到后端 |
| 限流熔断 | 基于令牌桶、漏桶算法限制请求速率，保护后端服务不被突发流量冲垮 | 单IP每秒最多100次请求，超出返回429 |
| 协议转换 | 将外部HTTP请求转换为内部gRPC、Thrift或Dubbo协议 | 前端HTTP请求 → 网关 → 后端gRPC服务 |
| 日志监控 | 记录全量请求日志，采集延迟、错误率、QPS等指标 | 统一输出访问日志到ELK，上报指标到Prometheus |
1.3 常见网关方案对比
业界主流的API网关方案各有优劣，选择时需要综合考虑性能、扩展性、生态和团队技术栈。以下从性能、扩展性、配置复杂度、Go生态适配四个维度进行对比：
| 对比维度 | Nginx + Lua (OpenResty) | Kong | Go自研网关 |
|---|---|---|---|
| 性能 | 极高（C语言核心，事件驱动） | 高（基于OpenResty，插件增加开销） | 高（Go原生并发，零拷贝优化） |
| 扩展性 | 通过Lua脚本扩展，灵活但维护成本高 | 插件市场丰富，支持自定义插件 | 完全可控，按需开发中间件 |
| 配置复杂度 | 静态配置文件为主，动态更新需reload | 支持声明式配置和Admin API，学习曲线中等 | 代码即配置，可集成配置中心动态下发 |
| Go生态适配 | 需额外开发Lua与Go的通信桥接 | 通过插件调用Go服务，间接集成 | 原生支持Go中间件、gRPC、Go服务发现 |
| 社区与生态 | 成熟稳定，文档丰富 | 企业级功能完善，商业支持 | 需自行构建，但灵活度最高 |
| 适用场景 | 高并发、静态路由为主的场景 | 需要丰富插件和可视化管理的企业 | 深度定制、Go技术栈团队、业务网关 |
课程选择：本课程采用Go自研网关方案，原因有三：一是Go语言在并发处理和网络编程方面天然优势；二是自研网关可以完全掌控路由、负载均衡、中间件等核心逻辑，便于教学演示；三是Go生态（如gin、grpc、etcd）为网关开发提供了成熟的基础组件。
1.4 课程项目整体架构图
本课程将构建一个完整的业务接口API网关，包含网关核心层、中间件层、后端服务层和基础设施层。下图展示了项目的整体架构：
1.5 课程核心模块拆解
围绕上述架构图，本课程将按以下模块逐步实现：
- 路由模块：基于前缀树（Trie）实现高性能路由匹配，支持路径参数、通配符和优先级路由。
- 负载均衡模块：实现轮询、加权轮询、一致性哈希、最少连接数四种策略，支持动态权重调整。
- 中间件链：设计可插拔的中间件执行链，内置认证、限流、日志、熔断中间件，支持自定义扩展。
- 服务发现与健康检查：集成etcd实现服务注册与发现，支持主动/被动健康检查，自动剔除故障节点。
- 限流与熔断：基于令牌桶实现分布式限流，基于滑动窗口实现熔断降级，保护后端服务稳定性。
- 监控与可观测性：集成Prometheus指标采集、结构化日志输出、链路追踪（OpenTelemetry）。
学习前提：本课程要求读者具备Go语言基础（接口、协程、channel、HTTP编程），了解微服务基本概念。每章都会提供完整的代码示例和可运行的测试用例，建议读者边学边练，在本地搭建实验环境。
1.6 网关请求处理流程（时序视角）
为了更直观地理解网关的工作方式，下图展示了一次完整请求从客户端到后端服务再返回响应的时序流程：
从时序图可以看出，网关在请求处理中扮演了调度中枢的角色：先进行路由匹配，然后依次执行中间件链（认证、限流、日志等），再通过负载均衡策略选择后端实例，最后转发请求并聚合响应返回给客户端。整个过程在Go中通过中间件模式 + 反向代理高效实现。
本章小结：API网关是微服务架构的流量入口和治理核心。通过对比Nginx、Kong和Go自研网关的优劣，我们明确了本课程选择Go自研的技术路线。课程项目将围绕路由、负载均衡、中间件、服务发现、限流熔断和监控六大模块展开，最终构建一个生产可用的业务接口网关。下一章我们将从零搭建网关的基础骨架，实现核心的路由匹配引擎。