SpringBoot 3.5.10引入springdoc-openapi-starter-webmvc-ui版本

ahauedu2026-01-29 10:07

SpringBoot 3.5.10 引入openapi 3.0.1包，包版本过高报错；

pom.xml

xml 复制代码

        <dependency>
            <groupId>org.springdoc</groupId>
            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
            <version>3.0.1</version>
            <scope>compile</scope>
        </dependency>

版本过高编译即报错编译失败：

复制代码

***************************
APPLICATION FAILED TO START
***************************

Description:

The bean 'conventionErrorViewResolver', defined in class path resource [org/springframework/boot/webmvc/autoconfigure/error/ErrorMvcAutoConfiguration$DefaultErrorViewResolverConfiguration.class], could not be registered. A bean with that name has already been defined in class path resource [org/springframework/boot/autoconfigure/web/servlet/error/ErrorMvcAutoConfiguration$DefaultErrorViewResolverConfiguration.class] and overriding is disabled.

Action:

Consider renaming one of the beans or enabling overriding by setting spring.main.allow-bean-definition-overriding=true

Disconnected from the target VM, address: '127.0.0.1:60346', transport: 'socket'

SpringBoot 3.5.10 引入openapi 2.6.0包，openapi包版本过低报错；

xml 复制代码

 <!-- SpringDoc OpenAPI（接口文档，替代Swagger2） -->
        <dependency>
            <groupId>org.springdoc</groupId>
            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
			<version>2.6.0</version>
            <scope>compile</scope>
        </dependency>

版本过低：

服务器内部错误:Handler dispatch failed: java.lang.NoSuchMethodError: 'void o

实践结论：

jdk17 ，springboot3.5.10 ，使用openapi 版本在 2.7.0 - 2.8.15 区间的都可以。