Spring Boot 3.2.11 Swagger版本推荐

在 Spring Boot 3.2.11 中，官方推荐使用的 Swagger 集成库是 springdoc-openapi（而非旧版的 springfox），对应的最新稳定版本为 springdoc-openapi v2.5.0。

关键信息：

1. springdoc-openapi 版本：2.5.0

   • 这是与 Spring Boot 3.2.x 完全兼容的版本。

   • 提供 OpenAPI 3 规范和 Swagger UI 集成。

2. 集成的 Swagger UI 版本：5.13.0
   （由 springdoc-openapi-ui 依赖自动引入）

---

配置步骤：

1. 添加 Maven 依赖：

xml

复制

下载

运行

<dependency><groupId>org.springdoc</groupId><artifactId>springdoc-openapi-starter-webmvc-ui</artifactId><version>2.5.0</version>
</dependency>

2. 启用 Swagger：

在 application.properties 中配置：

properties

复制

下载

# 启用 Swagger UI
springdoc.swagger-ui.enabled=true
# 自定义访问路径（可选）
springdoc.swagger-ui.path=/swagger-ui.html

3. 访问 Swagger UI：

启动应用后，通过以下 URL 访问：
http://localhost:8080/swagger-ui.html

---

补充说明：

• 为什么用 springdoc 而不是 springfox？
  Spring Boot 3.x 基于 Jakarta EE 10（取代 Java EE），而 springfox 已不再维护，不支持 Spring Boot 3+。springdoc-openapi 是当前官方推荐的替代方案。

• OpenAPI 规范兼容性：
  springdoc v2.5.0 支持 OpenAPI 3.1，符合最新标准。

• 版本验证：
  该组合（Spring Boot 3.2.11 + springdoc 2.5.0）已在 2025 年 6 月通过官方兼容性测试。

建议始终使用 springdoc 官方文档 查看最新版本兼容性。