Swagger @API tags中含有中文异常
yasserJin 人气:0Swagger @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>
以上为个人经验,希望能给大家一个参考,也希望大家多多支持。
加载全部内容