spring boot + swagger报错记录

最新推荐文章于 2024-08-12 17:16:00 发布
原创 最新推荐文章于 2024-08-12 17:16:00 发布 · 319 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#swagger2

本文讲述了Spring Boot 2.4项目中由于版本不兼容导致与Swagger 2.2.2集成失败的问题，通过将Swagger版本更新到2.9.2解决了启动报错，关键在于版本对应和配置调整。

springboot 整合 swagger2 报错，项目不能启动

APPLICATION FAILED TO START

Description:

Parameter 0 of method linkDiscoverers in org.springframework.hateoas.config.HateoasConfiguration required a single bean, but 15 were found:
- modelBuilderPluginRegistry: defined in null
- modelPropertyBuilderPluginRegistry: defined in null
- typeNameProviderPluginRegistry: defined in null
- documentationPluginRegistry: defined in null
- apiListingBuilderPluginRegistry: defined in null
- operationBuilderPluginRegistry: defined in null
- parameterBuilderPluginRegistry: defined in null
- expandedParameterBuilderPluginRegistry: defined in null
- resourceGroupingStrategyRegistry: defined in null
- operationModelsProviderPluginRegistry: defined in null
- defaultsProviderPluginRegistry: defined in null
- pathDecoratorRegistry: defined in null
- relProviderPluginRegistry: defined by method ‘relProviderPluginRegistry’ in class path resource [org/springframework/hateoas/config/HateoasConfiguration.class]
- linkDiscovererRegistry: defined in null
- entityLinksPluginRegistry: defined by method ‘entityLinksPluginRegistry’ in class path resource [org/springframework/hateoas/config/WebMvcEntityLinksConfiguration.class]

Action:

Consider marking one of the beans as @Primary, updating the consumer to accept multiple beans, or using @Qualifier to identify the bean that should be consumed

Process finished with exit code 0

原因：

spring boot与swagger的版本冲突了，这里我springboot项目的版本高了，swagger版本低了，不兼容。我的springboot版本为2.4，swagger版本为2.2.2，项目启动就会报如下错误：(这个问题的解决办法就是直接将pom文件中的swagger版本换成2.9.2就可以了)

spring boot引入swagger报错处理
山野里的小菊花
06-26 1960
swagger 2.0版本和spring boot 3.x版本整合暂时是不行的，因为swagger的依赖底层用的是javax依赖包，而spring boot 3.x版本都是jakarta依赖包，一般是把spring boot2.5以下就可以了，但是想要2.5版本以上spring boot启动就会出报错。网上搜索了各种办法，包括clone别人的代码，感觉明明一模一样的，为什么别人就可以，自己的就不行。有位作者已经写的很清楚了，此处不再赘述，，没错，就是版本兼容问题，说干就干。
初学Java 从0-1创建Spring boot+Mybatis - plus+Swagger2+Mysql（代码生成器）
博哥哥的博客
10-28 1730
初学者必看！！！创建Spring boot+Mybatis-plus+Swagger2+Mysql（代码生成器）
SpringBoot集成SwaggerUi以及启动时遇到的错误
08-19
主要介绍了SpringBoot集成SwaggerUi以及启动时遇到的错误，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
springboot和swagger版本匹配后仍报错
sylvia688的博客
06-30 122
有友友知道怎么回事吗。
springfox 源码分析(十四) 归档得到ApiListing接口集合
八一菜刀的专栏
10-07 1266
在前面我们拿到了接口的Model类型集合,然后还获取到了该接口的ApiDescription描述信息 此时针对这些信息,进行接口的资源整合,最终构造ApiListing类 /*** * 通过已经筛选过滤的接口集合以及context上下文对象来得到接口列表 * @param context * @return */ public Multimap<String, ApiListi...
Springboot集成Swagger报错
m0_37978198的博客
04-18 381
springboot集成swagger报错，问题记录。
Springboot集成Swagger2无法正常启动
Foreverovewenwen的博客
03-14 3974
在网上找了半天没找到解决方案，求大神帮忙
Spring Boot整合Swagger报错：“this.condition“ is null
jmysql的博客
09-27 1063
前段时间看到群里有吐槽swagger整合问题，当时没仔细看，总以为是姿势不对。
【非降版本解决】高版本Spring boot Swagger 报错解决方案
艾利克斯冰的博客
04-21 2776
问题 Spring Boot 2.6.x版本引入依赖 springfox-boot-starter (Swagger 3.0) 后，启动容器会报错： Failed to start bean ‘ documentationPluginsBootstrapper ‘ ; nested exception… 原因 Springfox 假设 Spring MVC 的路径匹配策略是 ant-path-matcher，而 Spring Boot 2.6.x版本的默认匹配策略是 path-pat...
springboot整合swagger2犯过的错
weixin_46531153的博客
01-15 484
关于这个文档 临近期末考，发现swagger真的很好用（当然考试肯定要用到），自己在学习过程中也不可避免的踩到了一些坑，我在文章的末尾加上了我遇到的坑（其实是自己菜）。所以记录一下。 关于swagger2 swagger是一款让你有更好的书写API文档的框架。在开发新版本或者迭代版本的时候，只需要更新Swagger描述文件，就可以自动生成接口文档和客户端服务端代码，做到调用端代码、服务端代码以及接口文档的一致性。 常用的注解如下： @Api()用于类名 @ApiOperation()用于方法名 @ApiP
springfox 源码分析(五) web配置类Plugin插件的使用
八一菜刀的专栏
10-06 3841
时间：2019-5-23 14:46:50 地点：家中 前言 我们在上一篇文章,通过@EnableSwagger2注解,知道springfox使用开启Plugin注解的配置,注入了很多Plugin的配置类，结合我们第二篇针对Spring Plugin的使用文章介绍,该篇主要探索springfox中的各种不同Plugin的具体作用,以及声明了那些方法 插件 在SpringfoxWebMvc...
required a single bean, but 2 were found
Json_Marz的博客
09-08 728
原因是在启动类加 `@ComponentScan` 注解，配置的包扫描路径重复了，导致重新生成两个bean，而且一个bean defined in null.因为xxljob组件是自己在xxljob的基础上封装的，然后项目启动报错，解决办法就是把包扫描的路径改下，不能有包含关系。
SpringBoot与Swagger整合Error starting ApplicationContext. To display the conditions report re-run your
weixin_45457983的博客
12-10 3020
在进行SpringBoot与Swagger整合配置过程中，出现了以下错误： Error starting ApplicationContext. To display the conditions report re-run your application with 'debug' enabled. 2020-12-10 15:14:16.587 ERROR 6536 --- [ main] o.s.b.d.LoggingFailureAnalysisReporter : **
Springboot整合Swagger2报错relProviderPluginRegistry: defined by method 'relProviderPluginRegistry' in cl
weixin_43749805的博客
01-16 1947
错误信息： *************************** APPLICATION FAILED TO START *************************** Description: Parameter 0 of method linkDiscoverers in org.springframework.hateoas.config.HateoasConfiguratio...
泛型依赖注入出现required a single bean, but 3 were found
qq_41967899的博客
12-11 7848
依赖注入1. 解决方法一方法二2. 问题3. 原因 1. 解决 方法一 找到问题提示的那几个类，选择一个作为主类来进行导入。比如我选择 @Primary public interface TbSysUserMapper extends MyMapper<TbSysUser> { } 方法二 将不能注入的bean也就是BaseServiceImpl 变成抽象类 @Service @T...
SpringBoot整合Swagger3.0使用及报错解决大全
7me
03-14 8932
Swagger是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法，参数和模型紧密集成到服务器端的代码，允许API来始终保持同步。
SpringBoot项目中Swagger的配置和使用
qq_38125626的博客
05-26 1315
转载自https://www.cnblogs.com/giswhw/p/14026283.html 一、概述 Swagger是一个规范、完整的框架，用于生成、描述、调用和可视化Restful风格的Web服务。使用Swagger可以使前端和后端人员实时的进行接口查看和协调。也可对相关的接口进行测试。 二、集成Swagger 1、创建基于Maven的项目，结构目录如下 2、添加swagger的pom.xml依赖 <?xml version="1.0" encoding=...
Spring Security和Swagger2集成报错
weixin_44919041的博客
10-12 3195
在项目中使用了swagger来方便测试接口，但是事与愿违 ，在项目启动的时候竟然报错了 具体报错代码 RequestMappingHandlerMapping requestMappingHandlerMapping = applicationContext.getBean(RequestMappingHandlerMapping.class); 报错内容如下： Method springSecurityFilterChain in org.springframework.security.c
mapper中bean定义存储异常,swagger的BeanCreationException:
qq_65102080的博客
08-12 756
跟着黑马程序员无脑粘贴pom，但是这边spring boot使用的是3.3.2 版本，而黑马那边使用的是Spring Boot 2.7.12 版本。这边使用的是黑马文档贴出来的依赖实际上应该用。spring boot版本与mybatis的版本不一致造成。直接用黑马资料给的项目在里面写代码就ok了。后面swagger报错也是一样的原因。
引入swagger报错
最新发布
03-15
### 解决 Spring Boot 项目中引入 Swagger 报错问题 在 Spring Boot 2.6.x 版本中，由于框架内部机制的变化以及依赖冲突等问题，在引入 `springfox-boot-starter` (即 Swagger 的实现) 后可能会遇到多种报错情况。以下是针对常见报错的解决方案。 #### 常见报错及其原因分析 1. **Failed to start bean ‘documentationPluginsBootstrapper’** 这种错误通常是因为 Spring Boot 2.6.x 默认禁用了 Bean 的循环引用检测功能[^1]。此外，Spring MVC 请求路径匹配器也发生了变化，从 `AntPathMatcher` 转变为 `PathPatternParser`，这可能导致某些旧版 Swagger 配置不兼容[^2]。 2. **NullPointerException 或其他运行时异常** 如果未正确配置 Swagger 或者存在版本不一致的情况，则可能引发 NullPointerException 等运行时异常[^3]。 --- #### 解决方案 ##### 方法一：调整 Maven 依赖并升级版本 确保使用的 `springfox-boot-starter` 是最新稳定版本，并与当前项目的 Spring Boot 版本保持兼容性。例如： ```xml <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-boot-starter</artifactId> <version>3.0.0</version> </dependency> ``` 如果仍然存在问题，可以尝试切换到更高版本的 `springfox-boot-starter`，或者考虑使用 OpenAPI 工具替代 Swagger。 ##### 方法二：启用循环引用支持 对于因默认禁用循环引用而导致的问题，可以通过设置属性重新允许循环引用。修改 `application.properties` 文件如下： ```properties spring.main.allow-circular-references=true ``` 此操作可有效解决部分由循环引用引起的启动失败问题。 ##### 方法三：更改 Path Pattern Parser 行为 为了适配新的路径解析逻辑，可以在应用初始化阶段强制恢复至旧版行为 (`AntPathMatcher`)。通过自定义配置类完成这一目标： ```java import org.springframework.context.annotation.Configuration; import org.springframework.web.servlet.config.annotation.PathMatchConfigurer; import org.springframework.web.servlet.config.annotation.WebMvcConfigurer; @Configuration public class WebConfig implements WebMvcConfigurer { @Override public void configurePathMatch(PathMatchConfigurer configurer) { configurer.setUseRegisteredSuffixPatternMatch(true); configurer.useSuffixPatternMatch(false); // 关闭后缀模式匹配 configurer.setPathMatcher(new AntPathMatcher()); // 使用传统方式 } } ``` 上述代码片段将路径匹配器重设为传统的 `AntPathMatcher` 实现。 ##### 方法四：排查 NPE 及其他潜在问题 当发生 NullPointer Exception 时，需重点检查以下几个方面： - 是否遗漏了必要的注解（如 `@EnableSwagger2` 或其等价形式）； - API 文档扫描包范围是否覆盖实际接口所在的模块； - Docket 配置是否存在语法错误或参数缺失。 典型配置示例： ```java import springfox.documentation.builders.ApiInfoBuilder; import springfox.documentation.service.ApiInfo; import springfox.documentation.spi.DocumentationType; import springfox.documentation.spring.web.plugins.Docket; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; @Configuration public class SwaggerConfiguration { @Bean public Docket api() { return new Docket(DocumentationType.OAS_30) .apiInfo(apiDetails()) .select() .build(); } private ApiInfo apiDetails() { return new ApiInfoBuilder().title("My Application API").description("Documentation for My App") .version("1.0").build(); } } ``` 以上代码展示了如何创建一个基本的 Docket 对象实例。 --- ### 总结 综合来看，Spring Boot 2.6.x 中集成 Swagger 所产生的各类问题主要源于新特性带来的向后兼容性挑战。通过对依赖管理、核心配置文件调整以及必要扩展手段的应用，能够显著降低此类风险的发生概率。
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值