Spring Boot整合Swagger出现NoClassDefFoundError错误求助

安全阿岳

2026-8-5

Spring Boot集成Swagger出现NoClassDefFoundError的原因及解决方法

错误信息

Exception in thread "main" java.lang.NoClassDefFoundError: org/springframework/core/metrics/ApplicationStartup

原因分析

Spring Boot 2.7.x版本与SpringFox 3.0.0存在依赖兼容性冲突。org.springframework.core.metrics.ApplicationStartup是Spring Framework 5.3+新增的类，但SpringFox 3.0.0内部依赖的Spring版本和Spring Boot 2.7.4所依赖的版本不匹配，导致运行时无法找到该类。
SpringFox 3.0.0已停止维护，官方不再更新以适配高版本Spring Boot，这也是兼容性问题的核心原因。

解决方法

方案一：替换为SpringDoc（推荐）

SpringDoc是官方推荐的Swagger替代方案，完美兼容Spring Boot 2.7+，操作步骤如下：

移除pom.xml中所有SpringFox相关依赖：

<!-- 删除以下SpringFox依赖 -->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>3.0.0</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>3.0.0</version>
</dependency>

添加SpringDoc依赖：

<dependency>
    <groupId>org.springdoc</groupId>
    <artifactId>springdoc-openapi-ui</artifactId>
    <version>1.6.14</version> <!-- 适配Spring Boot 2.7.x的稳定版本 -->
</dependency>

清理冗余配置：删除SwaggerConfiguration类，同时移除主类中的@Import({SwaggerConfiguration.class})注解。
启动项目后，访问http://localhost:8080/swagger-ui.html即可查看接口文档。

方案二：降级Spring Boot版本（不推荐，仅临时过渡）

若坚持使用SpringFox，可将Spring Boot版本降级到2.6.x及以下（如2.6.13），步骤如下：

修改pom.xml中spring-boot-starter-web的版本：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <version>2.6.13</version>
</dependency>