亲宝软件园·资讯

展开

Swagger @API tags中含有中文异常

yasserJin 人气:0

Swagger @API tags中含有中文异常

最近在接触新项目中用到了swagger,之前公司同事不喜好使用swagger也没有在意。我个人比较偏好swagger 文档开发,喜欢使用中文在标注各个接口。

重点

当前项目使用的是 swagger2     2.6.1  版本,这个版本有一个异常的地方:

在@API 注解中的 tags 包含中文后会导致界面UI接口方法不能正常伸缩,必须点击外层的  Expand Operations 才能正常使用

解决方法

这里使用的解决方法比较粗暴,升级swagger 版本  更新至 2.9.2,工程中引入更高级的swagger版本信息。

在引入后,记得打开浏览器,清除浏览器缓存。   

google 为例:

更新后的新版本界面,没有 Expand Operations这个一个按键了

Swagger注解@Api(tags={中文})无法点击展开

升级swagger依赖为2.9.2+

<dependency>
       <groupId>io.springfox</groupId>
       <artifactId>springfox-swagger2</artifactId>
       <version>2.9.2</version>
    </dependency>
    
    <dependency>
       <groupId>io.springfox</groupId>
       <artifactId>springfox-swagger-ui</artifactId>
       <version>2.9.2</version>
    </dependency>

以上为个人经验,希望能给大家一个参考,也希望大家多多支持。

加载全部内容

相关教程
猜你喜欢
用户评论