在使用swagger2的过程中,遇到了一些小坑,记录一下. 以前使用的时候没有遇到这种情况, 这两天使用的时候发现 swagger-ui 的界面中方法名称点击不能按照正常的展开 只能点击右上角的 List Operations 和 Expand Operations 进行所有方法的 展开和关闭, 使用起来特别麻烦. 在经过排查对比以前的项目代码, 终于发现原来是因为 类上的 API 注解的原因: 在API注解上的属性中有 value 和 tags 两个属性, Value的值不会展示在 UI界面上, tags会展示在界面上, 如下: 坑就再这个 tags 属性上面, 如果tags 中的值设置为中文, 那么 下面的方法名点击将不能被展开, 改成英文之后正常.value 值是否为中文不影响. |
|