Spring Boot 2.7.4集成Springfox Swagger-UI失效，求排查帮助

核心兼容性问题定位 #

Spring Boot 2.6+ 默认启用PathPatternParser作为路径匹配策略，但Springfox（3.x及以下版本）仍依赖传统的AntPathMatcher，这是导致Swagger端点映射失败、UI无法加载的最常见原因。

排查与修复步骤 #

1. 确认Springfox依赖版本 #

使用适配Spring Boot 2.7.x的Springfox版本，推荐直接引入springfox-boot-starter简化配置，避免零散依赖冲突：

<!-- pom.xml 中正确的Springfox依赖配置 -->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-boot-starter</artifactId>
    <version>3.0.0</version>
</dependency>

2. 切换路径匹配策略 #

在配置文件中强制使用AntPathMatcher，适配Springfox的路径解析逻辑：

# application.properties
spring.mvc.pathmatch.matching-strategy=ant_path_matcher

或者YAML格式：

# application.yml
spring:
  mvc:
    pathmatch:
      matching-strategy: ant_path_matcher

3. 校验SwaggerConfig配置 #

确保配置类正确扫描控制器包，无错误过滤规则：

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                // 替换为你的控制器实际包路径
                .apis(RequestHandlerSelectors.basePackage("com.your.project.controller"))
                .paths(PathSelectors.any())
                .build()
                .apiInfo(apiInfo());
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("项目API文档")
                .description("接口详细说明")
                .version("1.0.0")
                .build();
    }
}

4. 检查ApiDelegate实现类 #

确认控制器类添加了@RestController注解，且正确实现了OpenAPI Generator生成的ApiDelegate接口，保证接口路径被正确注册：

@RestController
public class DemoController implements DemoApiDelegate {
    @Override
    public ResponseEntity<DemoResp> getDemo(Long id) {
        // 业务逻辑实现
        return ResponseEntity.ok(new DemoResp());
    }
}

5. 验证Swagger UI访问路径 #

Springfox 3.x默认访问路径为http://localhost:8080/swagger-ui/（注意末尾斜杠），旧版本为/swagger-ui.html，确认访问路径正确。

6. 查看控制台错误日志 #

启动应用时关注控制台输出，若存在Swagger相关的Bean初始化失败、路径映射错误等日志，可直接定位问题根源。

额外场景处理（Spring Security） #

若项目集成了Spring Security，需放行Swagger相关端点，避免被拦截：

@Override
protected void configure(HttpSecurity http) throws Exception {
    http.authorizeRequests()
            .antMatchers("/swagger-ui/**", "/v2/api-docs", "/swagger-resources/**", "/webjars/**")
            .permitAll()
            .anyRequest().authenticated();
}

内容的提问来源于stack exchange，提问作者BMW83