Failed to start bean ‘documentationPluginsBootstrapper‘; nested exception is java.lang.NullPointerEx
Failed to start bean 'documentationPluginsBootstrapper'; nested exception is java.lang.NullPointerException
一、报错问题
报错信息:
Failed to start bean ‘documentationPluginsBootstrapper’; nested exception is java.lang.NullPointerException
二、问题发生背景
Spring Boot 整合 Swagger,用于生成 Web API 文档。
版本信息:spring boot:2.7.6,swagger:2.8.0
三、原因分析
springboot 升级到 2.6.0之后,swagger版本和springboot出现了不兼容情况,因为SpringBoot处理映射匹配的默认策略发生变化:
请求路径与 Spring MVC 处理映射匹配的默认策略已从AntPathMatcher更改为PathPatternParser
1. springboot 2.6.0之前:
public static class Pathmatch {
private MatchingStrategy matchingStrategy = MatchingStrategy.ANT_PATH_MATCHER;
}
2.springboot2.6.0之后
public static class Pathmatch {
private MatchingStrategy matchingStrategy = MatchingStrategy.PATH_PATTERN_PARSER;
}
四、解决方案
方案一:修改配置文件(最优,亲测)
升级springboot到2.6之后,需要修改配置文件来兼容Swagger2
application.properties:
spring.mvc.pathmatch.matching-strategy=ant_path_matcher
application.yml:
spring:
mvc:
pathmatch:
matching-strategy: ant_path_matcher
方案二:统筹规划SpringBoot和Swagger版本
swagger版本问题,升级3.0版本
或者
降低Spring Boot 版本,比如可以考虑将Spring Boot版本降低为2.5.6