Spring Boot集成springfox-boot-starter访问Swagger UI出现404无报错问题

算力阿峰

2026-8-4

问题解决方案

核心原因

SpringFox 3.0.0 并未适配 Spring Boot 3.x 版本——Spring Boot 3.x 基于 Jakarta EE（包前缀为jakarta.*），而 SpringFox 3.0.0 仍依赖旧的 Java EE（包前缀为javax.*），两者API规范不兼容，导致Swagger UI无法正常加载，添加@EnableSwagger2还会触发依赖缺失报错。

解决步骤

1. 移除SpringFox依赖

删除pom.xml中的SpringFox依赖：

<dependency>
  <groupId>io.springfox</groupId>
  <artifactId>springfox-boot-starter</artifactId>
  <version>3.0.0</version>
</dependency>

2. 添加SpringDoc OpenAPI依赖

SpringDoc是当前支持Spring Boot 3.x的主流Swagger替代方案，添加以下依赖到pom.xml：

<dependency>
  <groupId>org.springdoc</groupId>
  <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
  <version>2.2.0</version> <!-- 可根据官方最新版本调整 -->
</dependency>

3. 自定义配置（可选）

SpringDoc默认会自动扫描接口，无需额外配置类。如果需要自定义文档标题、版本等信息，可添加如下配置类：

@Configuration
public class OpenApiConfiguration {

    @Bean
    public OpenAPI customOpenAPI() {
        return new OpenAPI()
                .info(new Info()
                        .title("项目API文档")
                        .version("1.0.0")
                        .description("项目所有接口的详细说明"));
    }
}