Spring Boot 启动失败：Failed to start bean ‘documentationPluginsBootstrapper’ 解决方案

1. 问题描述

在使用 SpringFox Swagger 进行 API 文档管理时，Spring Boot 启动失败，报出如下错误：

Failed to start bean ‘documentationPluginsBootstrapper‘; nested exception is java.lang.NullPointerException

该错误通常发生在 Spring Boot 2.6+ 或 Spring Boot 3.x 版本，并且使用了 SpringFox 依赖，导致 documentationPluginsBootstrapper 这个 Bean 无法正常初始化。

---

2. 可能原因分析

原因 1：SpringFox 版本与 Spring Boot 版本不兼容 ❌

• SpringFox 3.0.0 不完全兼容 Spring Boot 2.6+ 及更高版本，可能导致 NullPointerException。
• Spring Boot 3.x 完全不支持 SpringFox，必须使用 springdoc-openapi 替代。

✅ 解决方案：添加兼容性配置（首选！！！！）

如果使用 Spring Boot 2.6+，可以在 application.yml 或 application.properties 中添加：

spring:
  mvc:
    pathmatch:
      matching-strategy: ant_path_matcher
spring.mvc.pathmatch.matching-strategy=ant_path_matcher

---

原因 2：SpringFox 依赖冲突 ⚠️

如果 pom.xml 或 build.gradle 存在多个 Swagger 相关依赖，可能会导致 SpringFox 初始化失败。

✅ 解决方案：确保只使用正确的 SpringFox 依赖

<dependency>
    <groupId>io.springfoxgroupId>
    <artifactId>springfox-boot-starterartifactId>
    <version>3.0.0version>
dependency>

⚠️ 删除可能冲突的 Swagger 依赖，如：

<dependency>
    <groupId>io.springfoxgroupId>
    <artifactId>springfox-swagger2artifactId>
    <version>2.x.xversion>
dependency>

---

原因 3：Spring Boot 3.x 不支持 SpringFox

Spring Boot 3.x 完全不兼容 SpringFox，建议直接更换 springdoc-openapi。

✅ 解决方案：使用 springdoc-openapi 替代 SpringFox

删除 SpringFox 相关依赖，改用 springdoc-openapi：

<dependency>
    <groupId>org.springdocgroupId>
    <artifactId>springdoc-openapi-starter-webmvc-uiartifactId>
    <version>2.2.0version>
dependency>

使用 springdoc-openapi 后，Swagger UI 访问地址变为：

http://localhost:8080/swagger-ui/index.html

---

原因 4：Swagger 配置文件错误

如果 SwaggerConfig.java 配置错误，可能导致 Bean 为空。

✅ 解决方案：检查 SwaggerConfig 配置

确保 SwaggerConfig.java 代码正确：

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.example.controller"))
                .paths(PathSelectors.any())
                .build();
    }
}

---

3. 解决方案总结 ✅

问题	解决方案
Spring Boot 2.6+ 与 SpringFox 3.0 不兼容	添加 spring.mvc.pathmatch.matching-strategy=ant_path_matcher
依赖冲突	确保 springfox-boot-starter 版本正确，删除旧版 Swagger 依赖
Spring Boot 3.x 不支持 SpringFox	改用 springdoc-openapi
Swagger 配置文件错误	确保 SwaggerConfig.java 配置正确

---

4. 结尾

✅ 如果使用 Spring Boot 3.x，建议直接使用 springdoc-openapi 代替 SpringFox。 ✅ 如果仍然使用 SpringFox，确保 springfox-boot-starter 版本正确，并添加 ant_path_matcher 配置。 ✅ 减少不必要的 Swagger 依赖，避免依赖冲突。