微服务网关路径 + Feign 调用 极简总结

一、核心结论

  1. 接口文档里的路径都是真实业务路径/api/v1/xxx,不带 /wemedia/user 这类网关标识。
  2. 服务自己的 Controller 只写业务路径/api/v1/xxx,保持纯净、独立、可直接测试。
  3. Feign 调用 = 目标服务真实路径,完全一致,不带任何网关前缀。
  4. 前端访问带的 /wemedia//user 是网关路由标识,由网关配置决定是否剥离。

二、两种网关配置对比(最关键)

1)带 StripPrefix=1(以 wemedia 为例)

复制代码
- id: wemedia
  uri: lb://leadnews-wemedia
  predicates: Path=/wemedia/**
  filters: StripPrefix=1
  • StripPrefix=1:转发时自动去掉第一个路径段 /wemedia
  • 前端请求:/wemedia/api/v1/channel/list
  • 网关转发后:/api/v1/channel/list
  • wemedia 真实接口:/api/v1/channel
  • admin 要调用它,必须写完整带前缀路径:/wemedia/api/v1/channel

2)不带 StripPrefix(以 user/auth 为例)

复制代码
- id: admin-user-auth
  uri: lb://leadnews-admin
  predicates: Path=/user/api/v1/auth/**
  • 无 StripPrefix:路径原样转发,不剥离
  • 前端请求:/user/api/v1/auth/list
  • 网关直接转给 admin:/user/api/v1/auth/list
  • admin 接口必须写:/user/api/v1/auth
  • admin 通过 Feign 调用 user 真实接口:/api/v1/auth

三、为什么 admin 要多写一层前缀?

  • admin 是后台统一入口,接收前端网关路由过来的完整路径
  • 权限、日志、统一格式都在 admin 控制
  • 再通过 Feign 调用目标服务的纯净业务接口
  • 结构清晰、职责分离、后期极好处维护

四、最终三层路径规则(背会就不会错)

  1. 前端 → 网关 :带标识 /wemedia/xxx/user/xxx
  2. 网关 → admin:按配置决定是否剥离前缀
  3. admin → Feign → 目标服务 :只用纯净业务路径 /api/v1/xxx
相关推荐
葡萄成熟时 !6 小时前
JAVA 常用API学习笔记
java·笔记·学习
画中有画7 小时前
MLOps 架构在大模型应用系统中的设计与实践
架构
Rain的Java大神之路7 小时前
介绍一下分布式事务
java·分布式·后端·spring·spring cloud·架构·springcloud
厚国兄7 小时前
大模型AI Agent记忆系统——Graphiti_源码架构与实现教程
架构·agent
canonical_entropy8 小时前
可逆不是逆向运行:DeepSeek Harness 架构的数学本质
人工智能·架构·agent
吴声子夜歌8 小时前
Java面试题——基础(一)
java·开发语言
南城以南溫暖如初1478 小时前
外卖CPS实战指南:从技术选型到运营落地全流程解析
java·spring boot·mysql·架构·vue
ZGIAI9 小时前
ZGI Workflow:让知识检索进入业务流程
人工智能·架构
ZGIAI9 小时前
ZGI 模型网关:统一接入与路由大模型
人工智能·架构
傻啦嘿哟9 小时前
英雄联盟皮肤爬虫:爬取全皮肤价格与特效,做比价工具
java·c++·爬虫