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

最新推荐文章于 2025-04-02 21:47:45 发布

Nikoooooooooooooo

最新推荐文章于 2025-04-02 21:47:45 发布

阅读量765

点赞数

文章标签： spring boot 后端 java

本文链接：https://blog.youkuaiyun.com/s1mple_or_simple/article/details/132403420

版权

文章讲述了在SpringBoot主程序启动时遇到的错误，源于国内Spring4All社区的swagger-spring-boot-starter与Swagger版本不兼容。解决方案是在SwaggerConfig中添加配置，解决了SpringBoot6.x与Swagger3.0.0的冲突，使得应用程序成功启动。

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

springboot主程序启动时出现报错

org.springframework.context.ApplicationContextException:
 Failed to start bean 'documentationPluginsBootstrapper';
 nested exception is java.lang.NullPointerException

查询发现是使用国内Spring4All社区开发的依赖swagger-spring-boot-starter 与自身的Swagger 发送了冲突

解决方法:

在配置中添加一个新配置项

@Configuration
@EnableSwagger2
public class SwaggerConfig {

    /**
     * 增加如下配置可解决Spring Boot 6.x 与Swagger 3.0.0 不兼容问题
     **/
    @Bean
    public WebMvcEndpointHandlerMapping webEndpointServletHandlerMapping(WebEndpointsSupplier webEndpointsSupplier, ServletEndpointsSupplier servletEndpointsSupplier, ControllerEndpointsSupplier controllerEndpointsSupplier, EndpointMediaTypes endpointMediaTypes, CorsEndpointProperties corsProperties, WebEndpointProperties webEndpointProperties, Environment environment) {
        List<ExposableEndpoint<?>> allEndpoints = new ArrayList();
        Collection<ExposableWebEndpoint> webEndpoints = webEndpointsSupplier.getEndpoints();
        allEndpoints.addAll(webEndpoints);
        allEndpoints.addAll(servletEndpointsSupplier.getEndpoints());
        allEndpoints.addAll(controllerEndpointsSupplier.getEndpoints());
        String basePath = webEndpointProperties.getBasePath();
        EndpointMapping endpointMapping = new EndpointMapping(basePath);
        boolean shouldRegisterLinksMapping = this.shouldRegisterLinksMapping(webEndpointProperties, environment, basePath);
        return new WebMvcEndpointHandlerMapping(endpointMapping, webEndpoints, endpointMediaTypes, corsProperties.toCorsConfiguration(), new EndpointLinksResolver(allEndpoints, basePath), shouldRegisterLinksMapping, null);
    }

    private boolean shouldRegisterLinksMapping(WebEndpointProperties webEndpointProperties, Environment environment, String basePath) {
        return webEndpointProperties.getDiscovery().isEnabled() && (StringUtils.hasText(basePath) || ManagementPortType.get(environment).equals(ManagementPortType.DIFFERENT));
    }
}

启动成功