Spring Boot及依赖升级后Springdoc-openapi-ui无法加载API定义求助

1. 修复Controller路径配置的致命错误 #

你提供的代码里存在语法使用错误：@RestController("/customer/")的写法完全不对。@RestController注解的参数是用来指定Bean名称的，不是请求路径前缀。正确的路径前缀配置应该用@RequestMapping注解：

@RestController
@RequestMapping("/customer/")
public class CustomerController { // 类名建议遵循大驼峰命名规范

    @Autowired
    CustomerRepository customerRepo;

    @GetMapping("/allCustomers")
    public List<Customer> getAllCustomers(){
         return customerRepo.findAll().toList();
    }

}

这个错误会导致Spring无法正确识别Controller的请求映射，springdoc自然扫描不到任何API接口，直接引发“加载API定义失败”的问题。

2. 适配Spring Boot 2.7.x的路径匹配策略 #

Spring Boot 2.7.x默认将路径匹配策略从ant-path-matcher切换为path-pattern-matcher，部分springdoc版本对新策略兼容性不佳。可以在配置文件中强制切回旧策略：

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

3. 配置springdoc的扫描规则 #

确保springdoc能正确扫描到你的Controller，可通过配置文件指定扫描范围：

springdoc.packages-to-scan=你的Controller所在包路径（例如com.example.controller）
springdoc.paths-to-match=/customer/**

4. 调整日志级别查看细节 #

你说日志无报错，大概率是日志级别过高过滤了关键信息。临时将日志级别调为DEBUG，查看springdoc初始化和接口扫描的详细过程：

logging.level.org.springdoc=DEBUG
logging.level.org.springframework.web=DEBUG

通过DEBUG日志能看到扫描是否成功、有没有隐藏异常，帮你定位核心问题。

5. 排查Classgraph版本兼容性 #

你升级了Classgraph到4.8.139，而springdoc内部依赖它做类扫描。可以尝试降级Classgraph到springdoc对应版本的默认依赖版本（比如springdoc 1.7.0默认依赖Classgraph 4.8.128），避免版本不兼容导致扫描失败。

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