v4.1.0版本-2023/03/23
大家好，Knife4j v4.1.0版本发版，本次版本发版主要解决两个问题：
- 🐛常规Bug修复：主要针对v4.0版本的异常bug、ui兼容性问题修复
- 🎄Spring Cloud Gateway网关聚合组件升级：提供手动、服务发现两种模式，轻松聚合OpenAPI文档
主要更新
🐛常规bug修复
1、网关聚合组件knife4j-gateway-spring-boot-starter针对OpenAPI3规范聚合时丢失context-path的支持，在ui层面做兼容
2、springdoc-openapi版本升级到最新版本1.6.15、2.0.4 Gitee#I6OIB1
3、knife4j-openapi3-jakarta-spring-boot-starter模块属性配置在idea不提示的异常情况处理
4、增强属性自定义文档加载分组的bug处理GitHub#PR525
5、knife4j-dependencies模块漏掉部分依赖模块版本定义的情况
6、解决不添加 springdoc-openapi-ui 依赖异常的问题Gitee#I66YJA**
7、针对OAS3规范中Parameter属性缺失字段说明的异常情况修复
8、针对OAS3规范中扩展属性包括排序、作者等不生效的问题Gitee#I6FB9I
9、部分字段翻译问题GitHub#540
10、使用增强属性开启production时出现的NPE异常GitHub#527
11、针对OpenAPI3规范的tag名称兼容性问题Gitee#I6JATP
12、实体类接收url参数时文档不显示参数说明的问题Gitee#I6H8CD
13、修复OAS3规范上传组件的识别问题Gitee#I6HAW0、GitHub#538
14、SpringWebflux框架的集成组件starter封装GitHub#521
15、针对Basic验证的特性增加include属性，允许开发者自定义配置GitHub#530
16、全局搜索框支持tag名称的模糊搜索Gitee#I6NWV6
🎄Spring Cloud Gateway网关聚合组件升级
在v4.1.0版本中，继续升级Spring Cloud Gateway网关聚合组件，提供discover服务发现的模式，自动聚合OpenAPI文档。使用方式更加简单，一个Starter组件+yml配置，即可完成网关层的聚合。
1、引入starter依赖，maven坐标如下：
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>knife4j-gateway-spring-boot-starter</artifactId>
<version>4.4.0</version>
</dependency>
2、基于discover模式自动聚合注册中心的文档，则最简洁的配置如下：
更多场景case的使用，可以参考knife4j-gateway-discussions
knife4j:
gateway:
enable: true
# 指定服务发现的模式聚合微服务文档，并且是默认`default`分组
strategy: discover
discover:
enable: true
# 指定版本号(Swagger2|OpenAPI3)
version : openapi3
如此，我们的聚合工作就完成了。
在浏览器访问Knife4j提供的文档地址：http://ip:网关端口/doc.html
示例程序
正是由于 4.0 的文档还在输出中，因此 Knife4j 在 4.0 新版本中也提供了不同版本的示例程序
示例如下：
- Spring Boot 2.x + OpenAPI2 规范：knife4j-spring-boot27-demo
- Spring Boot 2.x +OpenAPI3 规范：knife4j-springdoc-openapi-demo
- Spring Boot 3+ OpenAPI3 规范：knife4j-spring-boot3-demo
- Spring Cloud Gateway网关聚合：knife4j-openapi3-gateway
社区
感兴趣的朋友可以加群参与讨论贡献
关注公众号 "Knife4j"，点击菜单获取加群二维码
仓库坐标