秉承着能用就用新的的理念,在JDK、SpringBoot、SpringCloud版本的兼容性下,选择了Java17、SpringBoot3.0.2整合Swagger3。
代码编译一切正常,Swagger的Bean也能加载,到了最后访问前端页面swagger-ui的时候出现404。
根据网上资料:
1、Swagger3依赖不同,Swagger3的依赖是
xml
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-boot-starter</artifactId>
<version>3.0.0</version>
</dependency>
2、启动Swagger3的注解改变,Swagger3的启动注解为@EnableOpenApi
3、配置方法Docket中DocumentationType版本改变,变更为DocumentationType.OAS_30
3、访问地址变更,从之前的http://localhost:8080/swagger-ui.html变更为http://localhost:8080/swagger-ui/index.html#/
4、重写WebMvcConfigurer类中的addResourceHandlers接口
5、全局配置@RestControllerAdvice
,这个注解拦截了Swagger的返回地址,需要配置basePackages指定范围 @RestControllerAdvice(basePackages = {"net.exp.controller"})
到这里为止,都没有用还是没有解决访问404的问题。
根据Debug显示是在org.springframework.http.ResponseEntity
没有<init>
这个方法导致无法访问到swagger-ui页面。
本人技术到这里了,不知道是SpringBoot3里面做了拦截还是不兼容Swagger,没办法找到具体问题。
但是遇到问题解决问题,项目该做还得做,这里建议如果没有强制要求的情况下可以选择降低SpringBoot版本来兼容Swagger
或者不使用Swagger换一个其他的接口文档工具,这里个人推荐Apifox。
看到这里的小伙伴如果有解决办法了记得@我一下或者那个大牛找到了问题所在记得踢我一下我来学习一下。