gateway整合knife4j(微服务在线文档)

---

knife4j 微服务整合

由于单个服务的knife4j 整合之前已经写过了,那么由于效果比较好,然后微服务的项目中也想引入,所以开始微服务的这个之路;

---

一、微服务与单体项目文档整合的区别

1. 微服务中一般使用gateway作为统一路由(或者zuul), 单体项目不会使用
2. 微服务中的各个服务的文档分布在多个中,不像单体项目都在一个位置
3. 在线文档要统一所有接口,然后形成全量文档,所以需要整合各个微服务的接口到一起

二、开始整合

1. 搭建一个父子maven模块的微服务,并引入gateway

具体如何搭建,就不详细说了,感兴趣可以看看项目就好了 项目git地址

• 注册中心: nacos
• 路由: gateway

2.开始整合文档

主要参考的文章是 knife4j的官方文档

问题汇总

虽然实现了服务的聚合,文档也ok了,但是对于微服务的自定义前缀(项目名),这里的结构是对的,但是访问接口是错误的,不会加前缀
即使配置了 也不行 filters: - SwaggerHeaderFilter - StripPrefix=1
我项目中的版本与这个版本有一点差异也有可能是这个问题导致的

---

总结

下次我要尝试用zuul,因为knife4j的官网文档上说,zuul就不会有这个问题;

失败了，我整合了zuul 发现根本就不行，应该还是版本问题，先这样吧，zuul 不弄了~~~