Swagger @API tags中含有中文异常

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>

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