【Easylive】Gateway 路由分配与接口调用机制
【Easylive】项目常见问题解答（自用&持续更新中…） 汇总版
Spring Cloud Gateway 路由分配与接口调用机制
一、Gateway 路由分配原理
-
路由匹配流程
• 当请求到达网关（7071端口），Gateway 会遍历所有路由规则（routes），按predicates条件匹配• 示例路由配置：
- id: videouri: lb://easylive-cloud-web # 目标服务名（通过Nacos发现）predicates:- Path=/web/** # 路径匹配规则filters:- StripPrefix=1 # 去除前缀"/web"• 匹配逻辑：
localhost:7071/web/test→ 匹配Path=/web/**→ 转发到easylive-cloud-web服务的/test接口 -
Nacos 服务发现
•easylive-cloud-web已在Nacos注册（7072端口），网关通过lb://前缀从Nacos获取服务实例列表• 负载均衡：若
easylive-cloud-web有多个实例，Ribbon会轮询选择目标节点
二、接口访问路径差异解析
| 访问方式 | 实际调用链路 | 技术实现 |
|---|---|---|
localhost:7072/test | 直接访问easylive-cloud-web服务 | 绕过网关，直连服务端口 |
localhost:7071/web/test | 网关路由 → easylive-cloud-web:/test | Gateway的StripPrefix=1生效 |
• 关键区别：
• 网关路径需携带/web前缀（用于路由匹配），但实际转发时会剥离该前缀
• 直连服务路径无前缀，但会暴露服务端口（不符合微服务最佳实践）
三、负载均衡实例演示
-
场景准备
• 启动两个easylive-cloud-web实例（端口7072和7073）• Nacos服务列表显示：
easylive-cloud-web:- InstanceA: 127.0.0.1:7072- InstanceB: 127.0.0.1:7073 -
请求分发过程
• 连续调用localhost:7071/web/test时：◦ 第一次请求 → 转发到
InstanceA:7072/test◦ 第二次请求 → 转发到
InstanceB:7073/test◦ 第三次请求 → 再次转到
InstanceA（默认轮询策略） -
底层机制
// Gateway通过Ribbon实现负载均衡 LoadBalancerClient client = SpringContext.getBean(LoadBalancerClient.class); ServiceInstance instance = client.choose("easylive-cloud-web"); // 返回的实例会轮询变化
四、完整调用链路示例
-
请求示例
GET http://localhost:7071/web/api/videos/1 -
网关处理流程
• 匹配路由id:video→ 剥离/web前缀 → 目标路径变为/api/videos/1• 从Nacos获取
easylive-cloud-web实例地址（如127.0.0.1:7072）• 最终转发请求：
GET http://127.0.0.1:7072/api/videos/1 -
服务响应
•easylive-cloud-web处理请求后，响应数据通过网关原路返回
总结
• 网关路由：通过Path谓词匹配 + StripPrefix过滤实现路径转换
• 服务发现：依赖Nacos维护动态服务实例列表
• 负载均衡：由Ribbon自动处理多实例轮询
• 访问差异：网关路径需保留路由前缀，但实际转发时会被剥离
这种架构既保证了接口调用的灵活性，又隐藏了后端服务细节，符合微服务设计原则。
生活化解释
🚪 网关工作原理解析：你的智能快递驿站
想象你住在一个小区里，easylive-cloud-gateway 是小区唯一的快递驿站，而 easylive-cloud-web 是你家的具体门牌号。所有快递（请求）都要先经过驿站，再由驿站决定送到哪户人家。
1. 快递驿站的基础配置
驿站有两个重要信息：
server:port: 7071 # 驿站门牌号是7071
feign:okhttp:enabled: true # 驿站用的是高级智能分拣机
• 7071门牌：所有快递都必须送到这个驿站（网关统一入口）
• 智能分拣机：让驿站处理快递更快（OkHttp优化网络通信）
2. 快递配送规则（路由配置）
驿站里有个自动分拣系统：
routes:- id: videouri: lb://easylive-cloud-web # 你家地址predicates:- Path=/web/** # 快递上写着"/web/xxx"filters:- StripPrefix=1 # 撕掉"/web"标签再配送
• 工作流程：
- 快递员送来一个包裹，地址是
/web/test - 驿站看到
/web/开头，知道要送到easylive-cloud-web（你家） - 撕掉
/web标签，变成test - 把包裹送到你家真正的地址：
/test
3. 为什么两种方式都能收到快递？
| 配送方式 | 实际路径 | 比喻 |
|---|---|---|
localhost:7072/test | 直接敲你家门 | 快递员绕开驿站，直接送货上门 |
localhost:7071/web/test | 驿站转送（去掉/web） | 正规配送流程，经过统一管理 |
• 直接访问7072：就像快递员知道你家具体门牌，但违反小区规定（微服务最佳实践）
• 通过网关7071：符合规范，还能享受驿站的其他服务（鉴权、限流等）
4. 负载均衡：多个人轮流收快递
假设你家有双胞胎（两个服务实例）：
• 实例A：7072端口
• 实例B：7073端口
驿站的分拣系统（lb://）会：
- 第一个包裹 → 送给实例A
- 第二个包裹 → 送给实例B
- 第三个包裹 → 又给实例A
（默认轮询策略，确保两边工作量均衡）
5. 实例演示
场景1：普通访问
curl http://localhost:7071/web/hello
• 驿站收到 → 去掉/web → 转发到easylive-cloud-web的/hello
场景2：负载均衡测试
连续调用两次：
curl http://localhost:7071/web/api
curl http://localhost:7071/web/api
• 第一次可能由7072端口的实例处理
• 第二次就换7073端口的实例处理
🎯 核心优势
• 统一管理：所有快递经驿站中转，安全可控
• 灵活扩展：新增家庭成员（实例）只需在Nacos登记，驿站自动识别
• 故障隔离：如果实例A生病（宕机），驿站会自动把快递都给实例B