在使用swagger2的過程中,遇到了一些小坑,記錄一下. 以前使用的時(shí)候沒有遇到這種情況, 這兩天使用的時(shí)候發(fā)現(xiàn) swagger-ui 的界面中方法名稱點(diǎn)擊不能按照正常的展開 只能點(diǎn)擊右上角的 List Operations 和 Expand Operations 進(jìn)行所有方法的 展開和關(guān)閉, 使用起來特別麻煩. 在經(jīng)過排查對(duì)比以前的項(xiàng)目代碼, 終于發(fā)現(xiàn)原來是因?yàn)?類上的 API 注解的原因: 在API注解上的屬性中有 value 和 tags 兩個(gè)屬性, Value的值不會(huì)展示在 UI界面上, tags會(huì)展示在界面上, 如下: 坑就再這個(gè) tags 屬性上面, 如果tags 中的值設(shè)置為中文, 那么 下面的方法名點(diǎn)擊將不能被展開, 改成英文之后正常.value 值是否為中文不影響. |
|