SpringDoc OpenAPI依赖选型：ui与webmvc-core区别及推荐

核心区别 #

• springdoc-openapi-webmvc-core：这是纯核心依赖，只管OpenAPI文档的生成逻辑——扫描Spring MVC控制器、解析@Operation这类注解、输出符合规范的JSON/YAML格式文档数据。它不带任何可视化界面，适合只需要后端提供文档接口的场景（比如给其他服务调用、或者自己做UI）。
• springdoc-openapi-ui：它是在springdoc-openapi-webmvc-core基础上打包的“全家桶”，除了核心的文档生成能力，还内置了Swagger UI页面。引入它之后，直接就能通过浏览器访问可视化的API调试界面，不用额外配置UI相关的内容。

Spring Cloud网关层的优先选择 #

在Spring Cloud网关场景下，得分情况看：

1. 如果你用的是Spring Cloud Gateway（WebFlux栈）：注意上面两个都是针对Servlet栈的，不适用。应该用springdoc-openapi-gateway-webflux-ui或者springdoc-openapi-webflux-core。
2. 若网关是Servlet栈（比如Zuul 1.x）：优先选springdoc-openapi-ui。网关层集成SpringDoc大多是为了统一展示所有微服务的API，可视化UI是刚需，直接用这个依赖一步到位，省得自己再配UI。
3. 要是你只需要网关输出OpenAPI的JSON数据（比如前端团队自己做文档界面），那可以只引入springdoc-openapi-webmvc-core，减少不必要的依赖。

额外提醒 #

• 网关层集成时，得配置springdoc.swagger-ui.urls来指定各个微服务的OpenAPI文档地址，这样才能在网关的UI上统一展示所有接口。
• 注意依赖版本和你的Spring Boot、Spring Cloud版本匹配，避免出现类冲突或者功能失效的问题。

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