gateway整合knife4j(微服务在线文档)
文章目录
- knife4j 微服务整合
- 一、微服务与单体项目文档整合的区别
- 二、开始整合
- 1. 搭建一个父子maven模块的微服务,并引入gateway
- 2.开始整合文档
- 总结
knife4j 微服务整合
由于单个服务的knife4j 整合之前已经写过了,那么由于效果比较好,然后微服务的项目中也想引入,所以开始微服务的这个之路;
一、微服务与单体项目文档整合的区别
- 微服务中一般使用gateway作为统一路由(或者zuul), 单体项目不会使用
- 微服务中的各个服务的文档分布在多个中,不像单体项目都在一个位置
- 在线文档要统一所有接口,然后形成全量文档,所以需要整合各个微服务的接口到一起
二、开始整合
1. 搭建一个父子maven模块的微服务,并引入gateway
具体如何搭建,就不详细说了,感兴趣可以看看项目就好了 项目git地址
- 注册中心: nacos
- 路由: gateway
2.开始整合文档
主要参考的文章是 knife4j的官方文档
问题汇总
虽然实现了服务的聚合,文档也ok了,但是对于微服务的自定义前缀(项目名),这里的结构是对的,但是访问接口是错误的,不会加前缀
即使配置了 也不行filters: - SwaggerHeaderFilter - StripPrefix=1
我项目中的版本与这个版本有一点差异也有可能是这个问题导致的
总结
下次我要尝试用zuul,因为knife4j的官网文档上说,zuul就不会有这个问题;
失败了，我整合了zuul 发现根本就不行，应该还是版本问题，先这样吧，zuul 不弄了~~~