Spring Boot 2.6.x + Springfox(Swagger) 3.0.0 的不兼容问题

核心报错:

Failed to start bean 'documentationPluginsBootstrapper' Caused by: java.lang.NullPointerException at springfox.documentation.spring.web.WebMvcPatternsRequestConditionWrapper.getPatterns

问题描述:

Springfox 3.0.0 无法适配 Spring Boot 2.6.x 的路径匹配策略

解决方案一:添加配置

在application.yml添加下面的配置

▼
text
复制代码
spring:
  profiles:
    active: dev
    
mvc:
    pathmatch:
      matching-strategy: ANT_PATH_MATCHER

注意嵌套结构!

解决方案二:直接换成 SpringDoc（新标准）

(1)删除 Springfox / Knife4j（Swagger 老体系）: pom.xml 删除这些：

▼
text
复制代码
springfox-boot-starter
knife4j-spring-boot-starter

application.yml删掉这些:

▼
text
复制代码
spring:
  profiles:
    active: dev
    
mvc:
    pathmatch:
      matching-strategy: ANT_PATH_MATCHER

(2)pom.xml添加下面的依赖:

▼
text
复制代码
<dependency>
    <groupId>org.springdoc</groupId>
    <artifactId>springdoc-openapi-ui</artifactId>
    <version>1.6.15</version>
</dependency>

访问地址: http://localhost:8080/api/swagger-ui.html

优点:不需要任何额外配置,100% 兼容 Spring Boot 2.6.x