swagger-ui.html渲染出错：Please indicate a valid Swagger or OpenAPI version field

最新推荐文章于 2025-05-20 19:49:55 发布

原创

最新推荐文章于 2025-05-20 19:49:55 发布 · 3.2k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#ui #spring cloud

文章介绍了在SpringDoc2.0.2版本中遇到的错误，包括Controller层中的私有方法、同一Controller层内重复的请求路径、DTO参数模型的特殊符号以及Swagger返回值结构问题。针对这些问题，提供了详细的场景分析和解决办法，如移除私有方法、调整请求路径、检查参数模型的特殊符号和修改返回值封装规则。

一、错误环境

在微服务框架中集成SpringDoc（2.0.2），并对接口返回值进行统一封装。具体环境配置如下：

spring boot：3.0.0版本
spring cloud：2022.0.0版本
spring cloud alibaba：2022.0.0.0-RC1版本
springdoc：2.0.2版本
fastjson2：2.0.22版本
在项目的主pom文件中引入如下依赖包

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