springboot集成swagger导致项目启动失败

springboot集成swagger,启动时抛出如下错误:

18:03:03.586 [main] INFO  o.s.b.a.l.ConditionEvaluationReportLoggingListener -
Error starting ApplicationContext. To display the conditions report re-run your application with 'debug' enabled.
18:03:03.601 [main] ERROR o.s.b.d.LoggingFailureAnalysisReporter -

***************************
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]

原因:
swagger版本问题,我本地springboot版本是2.3.1,引用swaggerb版本为2.2.2,导致项目启动失败

解决方案:
更换swagger版本,我这里换成了2.9.2版本,项目启动成功

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.9.2</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>2.9.2</version>
</dependency>
### RuoYi Spring Boot 3 集成 Swagger 时遇到的 YAMLException 解决方案 在处理 RuoYi 项目Spring Boot 3 和 Swagger集成过程中,如果遇到了 `YAMLException` 错误,这通常是因为配置文件中的某些部分不符合 YAML 文件的标准语法。为了有效解决问题并成功集成 Swagger,在项目的 pom.xml 中应确保引入了正确的依赖项[^3]。 对于具体的错误修复措施如下: #### 修改 application.yml 或者 application.properties 文件 当使用 YAML 格式的配置文件时,任何多余的空格或缩进不当都可能导致解析失败。因此建议仔细检查 `application.yml` 文件内的 swagger 相关配置条目是否有格式上的问题。例如,确认所有的冒号后面都有一个空格,并且保持一致性的缩进级别。 另外一种方法是切换到 properties 格式来规避潜在的 yaml 解析器兼容性难题;即把所有关于 swagger-ui 的设定迁移到 `.properties` 文件里去定义,像这样: ```properties # application.properties springfox.documentation.swagger.v2.path=/v2/api-docs ``` #### 更新 springdoc-openapi 依赖版本 考虑到当前使用的可能是较旧版的 openapi 库,而这些库可能并不完全支持最新的 Spring Boot 版本特性,所以更新至最新稳定发布的 springdoc-openapi 是必要的操作之一。可以在 Maven POM 文件内添加/替换为下面这段代码片段以获取最新版本的支持[^1]: ```xml <dependency> <groupId>org.springdoc</groupId> <artifactId>springdoc-openapi-ui</artifactId> <version>1.6.14</version><!-- 查找最新版本 --> </dependency> ``` #### 调整启动类注解方式 有时改变应用程序入口处所应用的特定于 Swagger 的注释也能够帮助消除一些异常情况的发生。尝试移除原有与 Swagger UI 显示有关联的一切自定义 Bean 定义或是组件扫描路径限制等复杂逻辑,仅保留最基本的 @EnableWebMvc 及其他业务所需的基础框架注释即可[^2]. 通过上述调整应该可以有效地解决由于 Yaml Exception 所引发的一系列问题,并顺利实现 RuoYi Vue Admin Template 下基于 Spring Boot 3 平台之上对 API 文档工具——Swagger 的正常加载显示功能。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值