Spring Boot 3.x 与 Springfox 2.9.2 不兼容，因 Spring Boot 3 基于 Jakarta EE 9+ 和 Spring Framework 6，移除了 org.springframework.util.comparator.InvertibleComparator 等旧类，导致 Springfox 启动时抛出 NoClassDefFoundError；推荐迁移到现代、 actively-maintained 的替代方案 Springdoc OpenAPI。
spring boot 3.x 与 springfox 2.9.2 不兼容，因 spring boot 3 基于 jakarta ee 9+ 和 spring framework 6，移除了 `org.springframework.util.comparator.invertiblecomparator` 等旧类，导致 springfox 启动时抛出 `noclassdeffounderror`；推荐迁移到现代、 actively-maintained 的替代方案 springdoc openapi。
Spring Boot 3.x（如您使用的 3.0.1 版本）已全面升级至 Spring Framework 6 和 Jakarta EE 9+ 规范，而 Springfox 2.9.2 发布于 2019 年，仅支持 Spring Boot 2.x（最高兼容至 2.2.x）。其核心依赖 spring-plugin-core:1.2.0.RELEASE 内部硬编码引用了已被 Spring Framework 6 移除的 org.springframework.util.comparator.InvertibleComparator 类——这正是您日志中 Caused by: java.lang.NoClassDefFoundError: org/springframework/util/comparator/InvertibleComparator 的根本原因。强行降级 Spring Boot 版本或尝试“修复” Springfox 不仅违背技术演进方向，更会引入安全风险与维护隐患。
✅ 正确解法：弃用 Springfox，采用官方推荐的 Springdoc OpenAPI
Springdoc 是当前 Spring 生态中事实标准的 OpenAPI 3 文档引擎，原生支持 Spring Boot 3、Jakarta EE、Reactive Web（WebFlux）、Spring Security 等，并提供零配置启动、注解驱动、UI 自动集成等特性。
✅ 迁移步骤（三步完成）
1. 移除 Springfox 依赖（关键！）
在 pom.xml 中彻底删除以下两行：
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.9.2</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.9.2</version>
</dependency>2. 引入 Springdoc OpenAPI（Starter 方式）
添加最新稳定版依赖（截至 2024 年，推荐 2.3.0+）：
<!-- Springdoc OpenAPI UI (Swagger UI) -->
<dependency>
<groupId>org.springdoc</groupId>
<artifactId>springdoc-openapi-starter-webmvc-api</artifactId>
<version>2.3.0</version>
</dependency>
<!-- 可选：如需 Swagger UI 页面（默认启用） -->
<dependency>
<groupId>org.springdoc</groupId>
<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
<version>2.3.0</version>
</dependency>? 提示：springdoc-openapi-starter-webmvc-api 是核心模块；-ui 模块自动提供 /swagger-ui.html 和 /swagger-ui/index.html 访问入口（Spring Boot 3 默认路径已更新为后者）。
3. 零配置启动（无需 Java 配置类）
Springdoc 在 Spring Boot 3 中开箱即用。启动应用后，直接访问：
- ? Swagger UI: http://localhost:8080/swagger-ui/index.html
- ? OpenAPI JSON: http://localhost:8080/v3/api-docs
如需自定义（如标题、版本、分组），可添加 application.yml 配置：
springdoc:
api-docs:
path: /v3/api-docs
swagger-ui:
path: /swagger-ui.html
operations-sorter: method
default-produces-media-type: application/json
default-consumes-media-type: application/json
info:
app:
name: Bookstore Manager API
description: RESTful API for managing bookstore resources
version: 1.0.0⚠️ 注意事项与常见问题
- 勿混用 Springfox 与 Springdoc：残留的 Springfox 注解（如 @Api, @ApiOperation）将被忽略；请改用 Springdoc 兼容的 @Tag, @Operation, @Parameter 等 Jakarta 注解（位于 org.springdoc.core.annotations 包下）。
- Lombok 兼容性：Springdoc 完美支持 Lombok（@Data, @Builder 等），无需额外配置。
-
Security 集成：若使用 Spring Security，需放行 Swagger 相关路径：
@Configuration public class SecurityConfig { @Bean public SecurityFilterChain filterChain(HttpSecurity http) throws Exception { http.authorizeHttpRequests(auth -> auth .requestMatchers("/swagger-ui/**", "/v3/api-docs/**").permitAll() .anyRequest().authenticated() ); return http.build(); } } - 性能提示：Springdoc 默认启用缓存，生产环境无需额外优化；如需禁用（调试用），设 springdoc.cache.disabled=true。
✅ 总结
Springfox 已成为历史技术债，其与 Spring Boot 3 的不兼容是设计层面的断裂，而非配置疏漏。您遇到的 38 个嵌套 UnsatisfiedDependencyException，本质是 Spring Framework 6 类路径清理引发的连锁失败。拥抱 Springdoc 不仅解决当前问题，更确保项目长期可维护性、安全性与生态一致性。 迁移成本极低（仅修改依赖 + 删除旧配置），且文档质量、响应速度与社区支持均显著优于 Springfox。立即行动，让您的 Bookstore Manager 项目回归现代 Spring 开发正轨。
