当前位置：首页 > news >正文

【常见BUG】Spring Boot 和 Springfox（Swagger）版本兼容问题

news 2025/6/28 17:03:52

???欢迎来到我的博客，很高兴能够在这里和您见面！希望您在这里可以感受到一份轻松愉快的氛围，不仅可以获得有趣的内容和知识，也可以畅所欲言、分享您的想法和见解。

推荐:kwan 的首页,持续学习,不断总结,共同进步,活到老学到老
导航
檀越剑指大厂系列:全面总结 java 核心技术,jvm,并发编程 redis,kafka,Spring,微服务等
常用开发工具系列:常用的开发工具,IDEA,Mac,Alfred,Git,typora 等
数据库系列:详细总结了常用数据库 mysql 技术点,以及工作中遇到的 mysql 问题等
新空间代码工作室:提供各种软件服务,承接各种毕业设计,毕业论文等
懒人运维系列:总结好用的命令,解放双手不香吗能用一个命令完成绝不用两个操作
数据结构与算法系列:总结数据结构和算法,不同类型针对性训练,提升编程思维,剑指大厂

非常期待和您一起在这个小小的网络世界里共同探索、学习和成长。??? 欢迎订阅本专栏

博客目录

- 一.报错信息
- 二.解决方案
- - 1.修改 Spring MVC 的路径匹配策略
  - 2.配置 WebMvcConfigurer
  - 3.检查依赖关系
  - 4.降低 SpringBoot 版本

一.报错信息

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

二.解决方案

根据提供的错误信息和搜索结果，这个问题通常与 Spring Boot 和 Springfox（Swagger）的集成有关。错误提示Failed to start bean 'documentationPluginsBootstrapper'; nested exception is java.lang.NullPointerException表明在 Spring Boot 应用启动过程中，documentationPluginsBootstrapper这个 bean 无法正常启动，原因是遇到了空指针异常（NullPointerException）。这通常是由于 Spring Boot 和 Springfox 的版本不兼容导致的路径匹配策略冲突。
在这里插入图片描述

1.修改 Spring MVC 的路径匹配策略

修改 Spring MVC 的路径匹配策略：Springfox 假设 Spring MVC 的路径匹配策略是ant-path-matcher，而 Spring Boot 2.6 及以上版本的默认匹配策略是path-pattern-matcher。您可以通过在application.yml或application.properties配置文件中添加以下配置来解决这个问题：

spring:mvc:pathmatch:matching-strategy: ant_path_matcher

这样可以将 Spring MVC 的路径匹配策略更改为ant-path-matcher，以兼容 Springfox 的要求。

2.配置 WebMvcConfigurer

配置 WebMvcConfigurer：您可以通过创建一个配置类并继承WebMvcConfigurationSupport，然后重写addResourceHandlers方法来解决静态资源路径问题：

@Configuration
public class WebMvcConfigurer extends WebMvcConfigurationSupport {@Overridepublic void addResourceHandlers(ResourceHandlerRegistry registry) {registry.addResourceHandler("/**").addResourceLocations("classpath:/static/");registry.addResourceHandler("swagger-ui.html", "doc.html").addResourceLocations("classpath:/META-INF/resources/");registry.addResourceHandler("/webjars/**").addResourceLocations("classpath:/META-INF/resources/webjars/");super.addResourceHandlers(registry);}
}

这样可以确保 Swagger 的静态资源能够被正确加载。

3.检查依赖关系

检查依赖关系：确保您的项目中包含了正确的 Spring Boot Actuator 依赖。如果您使用的是 Maven，可以在pom.xml文件中添加以下依赖：

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

这有助于确保documentationPluginsBootstrapper bean 能够正确创建。

4.降低 SpringBoot 版本

<parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>2.5.6</version><relativePath/>
</parent>