解决Failed to start bean ‘documentationPluginsBootstrapper‘； nested exception is java.lang.NullPointer

已于 2022-09-01 09:04:29 修改
阅读量2.9w 收藏 107
点赞数 79
分类专栏： Springboot Bug/Exception 文章标签： springboot
于 2022-04-24 17:35:01 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_40977118/article/details/124387411
版权

目录

1. 背景

  • 升级springboot版本从2.2到2.6.6后，同时使用swagger3，启动后报错
  • Failed to start bean ‘documentationPluginsBootstrapper’; nested exception is java.lang.NullPointerException

在这里插入图片描述

org.springframework.context.ApplicationContextException: Failed to start bean 'documentationPluginsBootstrapper'; nested exception is java.lang.NullPointerException
	at org.springframework.context.support.DefaultLifecycleProcessor.doStart(DefaultLifecycleProcessor.java:181) ~[spring-context-5.3.18.jar:5.3.18]
	at org.springframework.context.support.DefaultLifecycleProcessor.access$200(DefaultLifecycleProcessor.java:54) ~[spring-context-5.3.18.jar:5.3.18]
	at org.springframework.context.support.DefaultLifecycleProcessor$LifecycleGroup.start(DefaultLifecycleProcessor.java:356) ~[spring-context-5.3.18.jar:5.3.18]
	at java.base/java.lang.Iterable.forEach(Iterable.java:75) ~[na:na]
	at org.springframework.context.support.DefaultLifecycleProcessor.startBeans(DefaultLifecycleProcessor.java:155) ~[spring-context-5.3.18.jar:5.3.18]
	at org.springframework.context.support.DefaultLifecycleProcessor.onRefresh(DefaultLifecycleProcessor.java:123) ~[spring-context-5.3.18.jar:5.3.18]
	at org.springframework.context.support.AbstractApplicationContext.finishRefresh(AbstractApplicationContext.java:935) ~[spring-context-5.3.18.jar:5.3.18]
	at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:586) ~[spring-context-5.3.18.jar:5.3.18]
	at org.springframework.boot.web.servlet.context.ServletWebServerApplicationContext.refresh(ServletWebServerApplicationContext.java:145) ~[spring-boot-2.6.6.jar:2.6.6]
	at org.springframework.boot.SpringApplication.refresh(SpringApplication.java:740) ~[spring-boot-2.6.6.jar:2.6.6]
	at org.springframework.boot.SpringApplication.refreshContext(SpringApplication.java:415) ~[spring-boot-2.6.6.jar:2.6.6]
	at org.springframework.boot.SpringApplication.run(SpringApplication.java:303) ~[spring-boot-2.6.6.jar:2.6.6]
	at org.springframework.boot.SpringApplication.run(SpringApplication.java:1312) ~[spring-boot-2.6.6.jar:2.6.6]
	at org.springframework.boot.SpringApplication.run(SpringApplication.java:1301) ~[spring-boot-2.6.6.jar:2.6.6]
	at com.example.demo.DemoApplication.main(DemoApplication.java:10) ~[classes/:na]

2. 问题原因

  • https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-2.6-Release-Notes

  • 在SpringBoot2.6之后，Spring MVC 处理程序映射匹配请求路径的默认策略已从 AntPathMatcher 更改为PathPatternParser。如果需要切换为AntPathMatcher，官方给出的方法是配置spring.mvc.pathmatch.matching-strategy=ant_path_matcher

  • 但是actuator endpoints在2.6之后也使用基于 PathPattern 的 URL 匹配，而且actuator endpoints的路径匹配策略无法通过配置属性进行配置，如果同时使用Actuator和Springfox，会导致程序启动失败，所以只是进行上面的设置是不行的。

在这里插入图片描述

3. 解决办法

  • 因为springfox在2020年7月之后就停止更新了，所以无法通过升级springfox版本解决；

在这里插入图片描述

方法一、修改配置

1、依赖

  • pom.xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.6.6</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.example</groupId>
    <artifactId>demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>demo</name>
    <description>demo</description>
    <properties>
        <java.version>11</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!--actuator-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-actuator-autoconfigure</artifactId>
        </dependency>
        <!--swagger3-->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-boot-starter</artifactId>
            <version>3.0.0</version>
        </dependency>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>

    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <excludes>
                        <exclude>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                        </exclude>
                    </excludes>
                </configuration>
            </plugin>
        </plugins>
    </build>

</project>

2、在application.properties中设置

spring.mvc.pathmatch.matching-strategy=ant_path_matcher

3、在swagger配置类中添加以下代码

在这里插入图片描述

package com.example.demo.config;

import org.springframework.boot.actuate.autoconfigure.endpoint.web.CorsEndpointProperties;
import org.springframework.boot.actuate.autoconfigure.endpoint.web.WebEndpointProperties;
import org.springframework.boot.actuate.autoconfigure.web.server.ManagementPortType;
import org.springframework.boot.actuate.endpoint.ExposableEndpoint;
import org.springframework.boot.actuate.endpoint.web.EndpointLinksResolver;
import org.springframework.boot.actuate.endpoint.web.EndpointMapping;
import org.springframework.boot.actuate.endpoint.web.EndpointMediaTypes;
import org.springframework.boot.actuate.endpoint.web.ExposableWebEndpoint;
import org.springframework.boot.actuate.endpoint.web.WebEndpointsSupplier;
import org.springframework.boot.actuate.endpoint.web.annotation.ControllerEndpointsSupplier;
import org.springframework.boot.actuate.endpoint.web.annotation.ServletEndpointsSupplier;
import org.springframework.boot.actuate.endpoint.web.servlet.WebMvcEndpointHandlerMapping;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.env.Environment;
import org.springframework.util.StringUtils;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.oas.annotations.EnableOpenApi;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;

import java.util.ArrayList;
import java.util.Collection;
import java.util.List;

/**
 * @ClassName: SwaggerConfig
 * @Description:
 * @Author: Fisher
 * @Date: 2022/4/20 1:34 PM
 **/
@Configuration
@EnableOpenApi
public class SwaggerConfig {

    @Bean
    public Docket restApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .useDefaultResponseMessages(true)
                .forCodeGeneration(false)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.example"))
                .paths(PathSelectors.any())
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("title")
                .description("这里放描述")
                .contact(new Contact("Fisher", "https://blog.csdn.net/qq_40977118", "xxx@163.com"))
                .version("1.0")
                .build();
    }

    @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 =
            webEndpointProperties.getDiscovery().isEnabled() && (StringUtils.hasText(basePath)
                || ManagementPortType.get(environment).equals(ManagementPortType.DIFFERENT));
        return new WebMvcEndpointHandlerMapping(endpointMapping, webEndpoints, endpointMediaTypes,
            corsProperties.toCorsConfiguration(), new EndpointLinksResolver(allEndpoints, basePath),
            shouldRegisterLinksMapping, null);
    }

}
  • 这个WebMvcEndpointHandlerMapping会覆盖掉spring-boot-actuator-autoconfigure jar中默认的bean

在这里插入图片描述

  • 这个WebMvcEndpointHandlerMapping会覆盖掉spring-boot-actuator-autoconfigure jar中默认的bean，actuator endpoints就是在这里使用了PathPatternParser
  • 上述两个步骤使spring和spring actuator不设置默认的pathPatternsCondition，而是使用ant_path_matcher
  • 启动后访问http://localhost:8080/swagger-ui/index.html

在这里插入图片描述

方法二、将swagger切换成springdoc

1、依赖

  • pom.xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.6.6</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.example</groupId>
    <artifactId>demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>demo</name>
    <description>demo</description>
    <properties>
        <java.version>11</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!--springdoc-->
        <dependency>
            <groupId>org.springdoc</groupId>
            <artifactId>springdoc-openapi-ui</artifactId>
            <version>1.6.8</version>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>

    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <excludes>
                        <exclude>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                        </exclude>
                    </excludes>
                </configuration>
            </plugin>
        </plugins>
    </build>

</project>

2、在application.properties中设置

# 自定义文档访问的地址，http://localhost:8080/sss
springdoc.swagger-ui.path=/sss
# 需要扫描的包路径
springdoc.packagesToScan=com.example
# 匹配的url路径
springdoc.pathsToMatch=/*

3、配置类

package com.example.demo.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import io.swagger.v3.oas.models.ExternalDocumentation;
import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Info;
import io.swagger.v3.oas.models.info.License;

/**
 * @ClassName: SwaggerConfig
 * @Description:
 * @Author: Fisher
 * @Date: 2022/4/20 1:34 PM
 **/
@Configuration
public class SwaggerConfig {

    @Bean
    public OpenAPI springShopOpenAPI() {
        return new OpenAPI()
                .info(new Info().title("SpringShop API")
                        .description("Spring shop sample application")
                        .version("v0.0.1")
                        .license(new License().name("Apache 2.0").url("http://springdoc.org")))
                .externalDocs(new ExternalDocumentation()
                        .description("SpringShop Wiki Documentation")
                        .url("https://springshop.wiki.github.org/docs"));
    }
}
  • 启动后访问http://localhost:8080/sss，最终会重定向到http://localhost:8080/swagger-ui/index.html

在这里插入图片描述

Fisher3652
关注
  • 79
    点赞
  • 踩
  • 107
    收藏
    觉得还不错? 一键收藏
  • 11
    评论
专栏目录
解决 高版本SpringBoot整合Swagger 启动报错Failed to start bean ‘documentationPluginsBootstrapper‘ 问题
u014288878的博客
01-07 690
解决报错Failed to start bean ‘documentationPluginsBootstrapper‘ 问题
java.lang.NoClassDefFoundError: net/sf/ezmorph/Morpher异常解决方法
08-13
NULL 博文链接：https://bijian1013.iteye.com/blog/2305804
Springboot启动报错org.springframework.context.ApplicationContextException: Failed to start bean ‘documen
最新发布
weixin_36862250的博客
03-26 453
原因是springboot 2.7和swagger2版本有冲突。
IDEA报错之Failed to start bean ‘documentationPluginsBootstrapper‘问题及解决方案
m0_67402235的博客
06-03 1万+
笔者今日创建一个Spring Boot 项目准备做产品，基于IDEA搭建是非常容易的，但是万万没想到，居然一切顺理成章的创建之后，运行报错，非常痛惜，错误截图如下：核心错误： 测试经过：检查之前创建的框架结构，检查各种注解及相关代码，都正常，应该是没有问题的。把之前创建的Swagger2依赖移除，因为就这块代码配置是最后一步，想着从后往前的测试方法检查，至于这是什么，不必多讲，非常出名了，不过我还是喜欢2.7.0旧版，最新的应该2.9.2吧，比较扁平化点。 把依赖和相关的配置代码移除后，运行项目一切正常，看
关于SpringBoot整合Swagger2出现的问题综合及解决方案
热门推荐
初学程序员
07-03 4万+
错误信息如下：Unable to infer base url. This is common when using dynamic servlet registration or when the API is behind an API Gateway. The base url is the root of where all the swagger resources are serve...
ADB server didn't ACK,failed to start daemon的解决方法.docx
08-09
运行Android程序时，可能会出现 The connection to adb is down, and a severe error has occured.You must restart adb and Eclipse... 的错误
springboot整合swagger错误
夙白风语的博客
11-27 1935
错误介绍 2021-11-27 00:21:38.420 INFO 205300 --- [ main] o.apache.catalina.core.StandardService : Stopping service [Tomcat] 2021-11-27 00:21:38.432 INFO 205300 --- [ main] ConditionEvaluationReportLoggingListener : Error starting Appl
Failed to start bean ‘documentationPluginsBootstrapper‘； nested exception is java.lang.NullPointerEx
LQCV587的博客
06-22 1万+
该问题已解决！特此记录！欢迎指点分享！目录一 · 问题发生背景：二 · 框架版本：三 · 解决方案（着急可略过1 直接看 2 ）1、网上大概有 几种：2、我的方案 ，摒弃杂念从根本入手（1）继承 mvc的配置类 WebMvcConfigurationSupport （2）实现 WebMvcConfigurer 接口四 · 完整代码公司 Springboot1.5 - 升级 Springboot 2.7对拦截器不太明白时候，可以参考以下博文：Springboot 拦截器（Interceptor）详解_、
解决“Failed to start bean ‘documentationPluginsBootstrapper‘； nested exception is java.lang.NullPoint”
cxclll的博客
09-07 1万+
解决Failed to start bean 'documentationPluginsBootstrapper'; nested exception is java.lang.NullPointerException
常见报错Failed to start bean ‘documentationPluginsBootstrapper‘； nested exception is java.lang.NullPoint
weixin_53947323的博客
06-08 2998
发现这个错误的起因是本学期我们有一个软件开发的小组作业，在大家开发完代码提交到华为云的时候，我把代码拉取下来，各项配置好了之后，发现项目跑不起来，其中就有这个错误：Failed to start bean 'documentationPluginsBootstrapper';nested exception is java.lang.NullPointerException，经过网上的查询和自己的探索，有了以下的结果。
SpringBoot与Swagger集成时遇到的错误：Failed to start bean ‘documentationPluginsBootstrapper‘；
Best_T的博客
12-14 1449
【错误描述】： 【解决方案】： package com.chang.Config; import org.springframework.context.annotation.Configuration; import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry; import org.springframework.web.servlet.config.annotation.WebMvcC.
MySQL Daemon failed to start错误解决办法
09-09
主要介绍了MySQL Daemon failed to start错误解决办法的相关资料,需要的朋友可以参考下
Failed to read schema document
04-22
NULL 博文链接：https://songjianyong.iteye.com/blog/1943295
java解决nested exception is java.lang.OutOfMemoryError Java heap space
01-12
java解决nested exception is java.lang.OutOfMemoryError Java heap space 解决OOM
java.lang.NoSuchFieldError: Companion
06-16
<dependency> <groupId>com.squareup.okio</groupId> <artifactId>okio</artifactId> <version>2.8.0</version>
解决kali Linux 报错Failed to start network manager的补丁
03-16
解决kali Linux 报错Failed to start network manager的补丁，具体修复过程参考我的博客
解决Handler processing failed; nested exception is java.lang.NoClassDefFoundError_kmode exception
01-12
java解决Handler processing failed; nested exception is java.lang.NoClassDefFoundError
java.lang.OutOfMemoryError 错误整理及解决办法
09-01
主要介绍了java.lang.OutOfMemoryError 错误整理及解决办法的相关资料,需要的朋友可以参考下
Failed to convert value of type ‘java.lang.String’ to required type ‘java.util.Date’; nested except
01-07
Type 异常报告 消息 Failed to convert ... nested exception is java.lang.IllegalStateException: Cannot convert value of type 'java.lang.String' to required type 'java.util.Date': no matching editors or co
Failed to start bean documentationPluginsBootstrapper ; nested exception is java.lang.NullPointerException
09-11
根据引用中的信息，"Failed to start bean 'documentationPluginsBootstrapper'; nested exception is java.lang.NullPointerException" 是一个错误消息，说明在启动bean 'documentationPluginsBootstrapper'时发生了一个空指针异常。这个错误可能与项目中的某些配置或代码有关。 引用提到了一个解决方案，它演示了如何集成Spring Boot 2.6.15和Swagger 3.0.0，并解决了类似的问题。如果你在项目中需要集成Swagger，可以参考这个demo来解决这个问题。 引用中的pom.xml文件显示了项目的版本信息，但是与引用中提到的错误消息中提到的具体问题之间没有直接的联系。 综上所述，要解决 "Failed to start bean 'documentationPluginsBootstrapper'; nested exception is java.lang.NullPointerException" 的问题，你可以尝试参考引用中提供的demo来集成Swagger并解决这个问题。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 11
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值