一、错误描述
在项目里整合接口文档的时候,由于Springboot和Swagger版本不匹配的问题,报错如下:
二、解决方案
- 在 pom 文件中,将 springfox 注释掉,用 springdoc 代替:
<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-webmvc-api</artifactId>
<version>2.0.2</version>
</dependency>
- 在application.yml 加入:
springdoc:
swagger-ui.path: /swagger-ui.html
- 在SwaggerConfig.java文件加入:
import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Info;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration
public class SwaggerConfig {
//以下内容按需更改为自己需要的内容
@Bean
public OpenAPI springShopOpenAPI() {
return new OpenAPI()
.info(new Info().title("论坛系统API")
.description("论坛系统前后端分离API测试")
.version("v1"));
}
-
在浏览器输入url:http://127.0.0.1:9090/swagger-ui/index.html,如下显示即可(9090是我的端口号,更换自己的即可):