【springboot2.7.5整合swagger3.0.0版本冲突问题】

Dosage de fleurs

已于 2023-09-06 08:44:06 修改

阅读量259

点赞数

CC 4.0 BY-SA版权

文章标签： spring boot spring java

于 2023-09-05 15:55:22 首次发布

本文链接：https://blog.youkuaiyun.com/weixin_44032244/article/details/132687720

本文讲述了在SpringBoot项目中集成Swagger时遇到的版本冲突问题，提供了修改至特定版本的解决方法，并列出了不同SpringBoot和Swagger版本之间的对应关系。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

springboot集成swaggerban版本冲突问题

报错如下：
在这里插入图片描述
原因：版本冲突问题
解决办法：修改至对应版本
附上各版本间的对应关系springboot+swagger各版本整理

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

Dosage de fleurs

关注关注

0
点赞
踩
1

收藏

觉得还不错? 一键收藏
0
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

基于SpringBoot框架使用Swagger2

mystonelxj的博客

01-01

1423

Swagger是一套基于OpenAPI规范的开源工具，它有助于程序员快速编写最新的API接口文档。在网络上有很多基于SpringBoot框架使用Swagger2的范例说明，我参考了多个文档，发现在基于SpringBoot框架使用Swagger2时有需要注意的环节。下面我以实例演示相关使用。提示：以下是本篇文章正文内容，下面案例可供参考经过多个项目工程的设置对比，我得到以下验证结果版本2.9.2 的swagger2只能在低于版本2.6.0的SpringBoot框架下运行。

springboot集成swagger3出现如下错误：Failed to start bean ‘documentationPluginsBootstrapper‘； nested exception

sebeefe的博客

03-01

235

原因：这是因为Springfox使用的路径匹配是基于AntPathMatcher的，而Spring Boot 2.6.X使用的是PathPatternMatcher。解决：在application.properties里配置：spring.mvc.pathmatch.matching-strategy=ANT_PATH_MATCHER 1.导入依赖 <dependency> <groupId>io.springfox</groupId

参与评论您还未登录，请先登录后发表或查看评论

(已解决)SpringBoot2.7.5配置Swagger3.0.0不兼容问题，以及找不到接口

m0_73864532的博客

02-01

885

swagger能够开启，但是找不到接口。

Springboot整合Swagger3.0 冲突报错+完整demo

程程程的博客

01-13

1858

Springboot整合Swagger3.0 冲突报错修正后的完整demo（springboot2.6.2+Swagger3.0）可以参考完整springboot 2.6.2 + swagger 3.0 demo 错误一切记整合Swagger需要关注Springboot版本情况，我的初始版本是2.6.2，整合后抛出 Failed to start bean ‘documentationPluginsBootstrapper’; 的错误 Error starting ApplicationCo.

SpringBoot2.7.5集成Swagger3资源文件介绍：项目核心功能/场景

最新发布

gitblog_06745的博客

05-21

996

SpringBoot2.7.5集成Swagger3资源文件介绍：项目核心功能/场景去发现同类优质开源项目:https://gitcode.com/ 项目介绍在现代软件开发实践中，Spring Boot因其简洁的开发体验和强大的功能而受到开发者的青睐。在构建RESTful服务时，API文档的生成和管理是一项关键任务。Spring Boot 2.7.5集成Swagger 3资源文件正是为了满足这一...

【springboot2.7.5整合swagger3.0.0】

weixin_44032244的博客

09-05

959

其中，springboot与swagger的版本对应关系见。也可以采用注解的方式实现。配置时注意版本冲突问题。附：可能出现的其他问题。

Spring Boot 2.7.5 整合 Swagger 3 实现可交互的后端接口文档

Gjw_java的博客

11-22

3160

Springboot中actuator与Swagger3版本冲突造成 Failed to start bean ‘documentationPluginsBootstrapper‘

s1mple_or_simple的博客

08-21

802

查询发现是使用国内Spring4All社区开发的依赖swagger-spring-boot-starter 与自身的Swagger 发送了冲突。springboot主程序启动时出现报错。在配置中添加一个新配置项。

手把手教你解决spring boot导入swagger2版本冲突问题,刘老师教编程

2301_80354865的博客

07-05

1414

Swagger 2 的依赖底层使用的是 javax 依赖包，而 Spring Boot 3 使用的是 Jakarta 依赖包。一般来说，可以将 Spring Boot 的版本降到 3.0.1 以下来解决这个问题，但如果想要使用 3.0.1 版本以上的 Spring Boot，启动时就会出现报错。去pop.xml查看你springframework的版本，如果你已经是Spring boot3了，像我这里是当前的最新版3.3.1，那就改成2.7.2，改完之后点击右上角m形状的刷新按钮。

Spring Boot 2.7.5 集成 Swagger 3

11-22

Swagger 3，即OpenAPI Specification的第三个主要版本，是一个用于描述RESTful API的规范，它提供了强大的工具来生成、测试和文档化API。集成Swagger 3到Spring Boot项目中，可以帮助开发者更有效地管理和维护API，...

springboot 2.7 整合swagger3.0(knife4j)

qq_23327559的博客

07-06

2750

配置 springfoxHandlerProviderBeanPostProcessor 解决上面报错问题。4,启动项目,访问地址:ip:port/doc.html。production: true #开启生产环境屏蔽。enable: true #开启增强配置。因为版本问题会出现异常导出启动失败。basic: #基本的登录认证。3,springboot 配置。springboot 版本。

完整SpringBoot集成Swagger项目

11-09

SpringBoot集成Swagger，下载使用开发工具打开即可运行！！！ org.springframework.boot【spring-boot-starter-parent】相关版本2.7.5 io.springfox【springfox-boot-starter】版本3.0.0项目包含高低两个版本集成...

springboot整合swagger3依赖出现错误 Failed to load class “org.slf4j.impl.StaticLoggerBinder“.

weixin_73495056的博客

10-27

244

实际上，Swagger 3 已经被重命名为，使用 Spring Boot 等框架时，配合 Swagger 3（OpenAPI 3）通常需要使用依赖项，而不再使用较旧的。

SpringBoot 升级 SpringCloud & 整合 Nacos & 并解决Swagger版本冲突、循环依赖

qq_43571809的博客

07-20

1432

nacos-server安装 nacos api整合循环依赖问题 swagger版本冲突问题

Swagger配置问题（版本不兼容）

lzzz6262的博客

07-04

1139

Docket docket = new Docket(DocumentationType.SWAGGER_2) .groupName("接口") .apiInfo(apiInfo) .select() .apis(RequestHandlerSelectors.basePackage("com.house.controller")) .paths(PathSelectors.any()) .build();升级swagger不行，直接将spring版本呗，我就降到了spring2.5，成功运行。

【swagger与springboot版本不兼容问题】

后生晚辈。

08-23

1570

1.swagger依赖版本过高，我这里换成了2.9.2。

Springdoc-- 解决Swagger2与SpringBoot3版本以上不兼容的问题以及日常使用

m0_58462450的博客

01-05

2785

springboot版本：3.2.0在使用Swagger2的时候会发生项目启动报错。

springboot2.6.x版本与swagger3冲突的解决办法

weixin_45087338的博客

01-06

3029

springboot2.6.x版本与swagger3冲突的解决办法

解决springboot2.6和swagger冲突的四种方法

纵横千里捭阖四方的专栏

09-28

6486

最近要将后台服务从SpringBoot1升级到2版本，主要目的是为了使用SpringBoot2的实时监控功能。集成的时候无法启动，根据日志判断与swagger有关。查了半天，一个解释是springboot修改了请求路由匹配策略，Spring MVC 处理程序映射匹配请求路径的默认策略已从 AntPathMatcher 更改为PathPatternParser。Actuator端点现在也使用基于 PathPattern 的 URL 匹配，因此Actuator端点的路径匹配策略无法通过配置属性进行配置。

swagger2 与springboot版本匹配

03-27

<think>好的，我现在需要回答用户关于Swagger2与SpringBoot不同版本之间的兼容性关系的问题。首先，我得先理清用户提供的引用内容，看看里面有哪些有用的信息。用户提供了五个引用，其中提到不同版本的SpringBoot与Swagger的兼容性问题。例如，引用[2]提到SpringBoot 2.7.5存在兼容问题，需要降级到2.5.6，并配置`spring.mvc.pathmatch.matching-strategy=ant_path_matcher`。引用[3]指出SpringBoot 2.7以下可以使用Swagger2 2.9.2。引用[4]提到SpringBoot 3.0以上需要同样的配置。引用[5]则涉及SpringBoot 2.7.14尝试使用Swagger 3.0.0的情况。接下来，我需要整理这些信息，找出常见的版本对应关系。比如，SpringBoot 2.5.x及以下可能兼容Swagger2 2.9.x；而SpringBoot 2.6.x及以上可能需要额外的配置或者降级。对于SpringBoot 3.x以上，可能因为Spring框架的变化，需要不同的处理方式，比如使用SpringDoc替代。然后，我需要考虑用户可能遇到的问题，比如高版本SpringBoot与Swagger2的不兼容，这时候可能需要调整配置或者更换依赖。同时，用户可能想知道具体的版本对应表，以及解决方案，比如使用SpringDoc作为替代方案。还需要注意用户提供的引用中有提到不同的配置方法，比如设置`ant_path_matcher`来避免路径匹配问题。这可能是一个常见的解决方案，适用于SpringBoot 2.6.x及以上版本。最后，生成相关问题时要覆盖常见的疑问，比如如何解决兼容性问题，替代方案，配置方法等。</think>### Swagger2与SpringBoot版本兼容性关系总结 #### 一、核心版本对应关系 1. **SpringBoot ≤ 2.5.x** - 兼容 **Swagger2 (springfox) 2.9.x** - 示例配置： ```xml <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.9.2</version> </dependency> ``` 2. **SpringBoot 2.6.x - 2.7.x** - 需要添加**路径匹配策略配置**（高版本路径解析策略变化导致Swagger失效）： ```properties spring.mvc.pathmatch.matching-strategy=ant_path_matcher ``` - 若仍不兼容，可降级SpringBoot至2.5.x[^2][^5] 3. **SpringBoot ≥ 3.0.0** - **不再兼容Swagger2**，需使用替代方案 **SpringDoc OpenAPI**（基于Swagger3）[^4] --- #### 二、典型问题与解决方案 - **问题1：高版本SpringBoot启动报错** **现象**：SpringBoot 2.6.x及以上启动时提示`IllegalArgumentException` **解决**：在`application.properties`中添加路径匹配策略[^2] - **问题2：Swagger页面无法访问** **原因**：SpringBoot 3.x移除了对Springfox的支持 **解决**：改用SpringDoc依赖： ```xml <dependency> <groupId>org.springdoc</groupId> <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId> <version>2.2.0</version> </dependency> ``` --- #### 三、推荐实践 1. **SpringBoot 2.5.x及以下**：直接使用Swagger2 2.9.x 2. **SpringBoot 2.6.x及以上**： - 添加路径匹配配置 - 或升级Swagger依赖至3.0.x（需验证兼容性）[^5] 3. **SpringBoot 3.x**：必须使用SpringDoc（访问路径变为`/swagger-ui.html`） ---