Knife4j v4.3.0 发布，深挖 Gateway 网关聚合场景，解决各种疑难杂症

大家好，Knife4j v4.3.0版本发版了 

4.3.0版本主要解决在Spring Cloud Gateway网关组件下聚合Swagger2或者OpenAPI3提供最简单的配置，简化开发者工作。

最简单的配置如下(4个配置属性完成所有子服务的网关聚合)：

 knife4j:   gateway:     enabled: true     strategy: discover     discover:       # 聚合所有子服务(swagger2规范)，子服务是3规范则替换为openapi3       version: swagger2       enabled: true 

Maven坐标

 <dependency>     <groupId>com.github.xiaoymin</groupId>     <artifactId>knife4j-gateway-spring-boot-starter</artifactId>     <version>4.3.0</version> </dependency>  

更新日志

优化knife4j-gateway组件

1、在gateway网关聚合服务中，排除其他服务支持正则表达式

 knife4j:   gateway:     enabled: true     strategy: discover     discover:       version: swagger2       enabled: true       excluded-services:         # 排除order开头的配置         - order.* 

2、聚合子服务时，两个子服务是根路由转发时只聚合单个服务的bug(主要是order排序属性导致)

3、启用DisocverClient作为网关默认转发路由场景下聚合失败的问题

4、针对Swagger2规范聚合失败的问题

5、在手动聚合模式(manual)下同时支持swagger2和openapi3规范的聚合

 knife4j:   gateway:     enabled: true     strategy: manual     routes:       # swagger2       - name: 订单openapi2         service-name: user-service         url: /order-service-openapi2/v2/api-docs?group=default         context-path: /       # openapi3       - name: 订单openapi3         service-name: order-service         url: /order/v3/api-docs/default         context-path: /order 

6、在子服务全部是swagger2规范情况下contextPath路径错误的问题

7、优化knife4j-gateway的部分代码结构及聚合场景，目前聚合子服务路由在服务发现(discover)模式下主要4种模式，主要包括：

• 基于Spring Cloud Gateway配置的routes规则解析子服务路由，数据来源：spring.cloud.gateway.routes
• 在discover服务发现场景下，针对自定义添加的routes，默认再次追加，数据来源：knife4j.gateway.routes
• 服务发现discover模式下，开发者在网关成的路由转发模式默认通过DiscoveryClient的默认方式转发路由，规则是pattern:/service-id/**
• 接收编码方式动态注入Spring Cloud Gateway网关的路由，进行聚合转发

其他部分

1、修复@ApiSupport注解不生效的问题Gitee#PR89

2、数据存在枚举值时，SwaggerModel无法正常展开Gitee#PR90

3、解决组件冲突的问题GitHub#630

4、增加title属性的支持Gitee#I7KUYP

感谢

非常感谢以下开发者的PR贡献(排名不分先后)：

• lhzsdnu
• igeekfan