当前位置:首页 » 《休闲阅读》 » 正文

关于Swagger2.10.x版本,spring boot集成Swagge2.10.x(比如2.10.5)依赖问题,没有 @EnableSwagger 新注解@EnableSwagger2WebMvc

7 人参与  2024年04月15日 18:02  分类 : 《休闲阅读》  评论

点击全文阅读


1. Spring Boot 集成 Swagger2 常见依赖为:

<!-- Swagger2的依赖--><dependency>    <groupId>io.springfox</groupId>    <artifactId>springfox-swagger2</artifactId>    <version>2.10.5</version>  <!-- 2.10.5表示版本号,这个版本,现在是maven仓库中最高的版本--></dependency><!-- Swagger UI的依赖--><dependency>    <groupId>io.springfox</groupId>    <artifactId>springfox-swagger-ui</artifactId>    <version>2.10.5</version></dependency>

上面是正确的依赖,只需要换成不同版本即可,但换成 2.10.x 版本后报错:

Unable to infer base url. This is common when using dynamic servlet registration or when the API is behind an API Gateway…

浏览器访问报错图片:
在这里插入图片描述
解决:

访问路径还是:http://localhost:8080/swagger-ui.html但注意: 这个 2.10.x 版本有点特殊:没有 @EnableSwagger2 注解,所以配置类中需要出掉这个注解,然后添加 @EnableSwagger2WebMvc 注解。

并然后增加下面这个依赖:

<dependency>    <groupId>io.springfox</groupId>    <artifactId>springfox-spring-webmvc</artifactId>    <version>2.10.5</version>  <!--比如这里是2.10.5的版本--></dependency>

提示: 从 Swagger2.10.0 至 2.10.5,配置时,配置类(配置类在文章结尾给出)使用的注解开始分为 @EnableSwagger2WebMvc@EnableSwagger2WebFlux,用于区分 阻塞式编程框架响应式编程框架,并直接去除了@EnableSwagger2 注解。但是此时出现一个问题:不利于维护,因此 2.10.x 版本可以理解为一个测试版本。(常用版本为 2.9.4 或者最新的 3.0.0)

2. Spring Boot 使用 Swagger2.10.5 有关版本更新带来的其他问题:

现在需要传入后台的数据为 string 类型,但是使用 swagger-ui 接口进行测试的时候,输入的数据的类型其实是数字类型,不匹配,所以需要修改:对 pom.xml 文件进行调整:
在这里插入图片描述
将原来默认的 1.5.20 版本剔除,此时的 swagger.version 默认为 2.10.5,默认引入的为1.5.20,可以剔除再引入新的1.5.21

3. Spring Boot 集成 Swagger2 时的配置类:

// @EnableSwagger2@EnableSwagger2WebMvc //使配置生效@Configurationpublic class SwaggerConfiguration {    @Bean    public Docket getDocket() {        Docket docket = new Docket(DocumentationType.SWAGGER_2)                .apiInfo(getApiInfo())    //设置Swagger接口文档的首页信息                .select()   //初始化并返回一个API选择构造器                    .apis(RequestHandlerSelectors.any())   //选择将哪些接口生成API文档                    .paths(PathSelectors.any())    //可以根据url路径设置哪些请求加入文档,忽略哪些请求                .build();    //创建API文档        return docket;    }    //由于上面.apiInfo需要这个参数,所以这里写这个方法    private ApiInfo getApiInfo(){        //创建作者对象        Contact contact = new Contact("zfp","介绍这个人的链接","30888@qq.com");        ApiInfo apiInfo = new ApiInfoBuilder()                .title("《后端接口文档》")  //文档的标题                .description("文档的描述信息")  //文档的描述                .contact(contact)  //文档的作者                .version("V1.0") //文档的版本                .build();   //构建        return apiInfo;    }}

点击全文阅读


本文链接:http://zhangshiyu.com/post/95751.html

<< 上一篇 下一篇 >>

  • 评论(0)
  • 赞助本站

◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。

最新文章

  • 祖母寿宴,侯府冒牌嫡女被打脸了(沈屿安秦秀婉)阅读 -
  • 《雕花锦年,昭都旧梦》(裴辞鹤昭都)完结版小说全文免费阅读_最新热门小说《雕花锦年,昭都旧梦》(裴辞鹤昭都) -
  • 郊区41号(许洛竹王云云)完整版免费阅读_最新全本小说郊区41号(许洛竹王云云) -
  • 负我情深几许(白诗茵陆司宴)完结版小说阅读_最热门小说排行榜负我情深几许白诗茵陆司宴 -
  • 九胞胎孕妇赖上我萱萱蓉蓉免费阅读全文_免费小说在线看九胞胎孕妇赖上我萱萱蓉蓉 -
  • 为保白月光,侯爷拿我抵了债(谢景安花田)小说完结版_完结版小说全文免费阅读为保白月光,侯爷拿我抵了债谢景安花田 -
  • 陆望程映川上官硕《我的阿爹是带攻略系统的替身》最新章节阅读_(我的阿爹是带攻略系统的替身)全章节免费在线阅读陆望程映川上官硕
  • 郑雅琴魏旭明免费阅读_郑雅琴魏旭明小说全文阅读笔趣阁
  • 头条热门小说《乔书意贺宴临(乔书意贺宴临)》乔书意贺宴临(全集完整小说大结局)全文阅读笔趣阁
  • 完结好看小说跨年夜,老婆初恋送儿子故意出车祸_沈月柔林瀚枫完结的小说免费阅读推荐
  • 热推《郑雅琴魏旭明》郑雅琴魏旭明~小说全文阅读~完本【已完结】笔趣阁
  • 《你的遗憾与我无关》宋怀川冯洛洛无弹窗小说免费阅读_免费小说大全《你的遗憾与我无关》宋怀川冯洛洛 -

    关于我们 | 我要投稿 | 免责申明

    Copyright © 2020-2022 ZhangShiYu.com Rights Reserved.豫ICP备2022013469号-1