swagger2中UI介面介面點選無法展開問題解決

2022-02-24 21:33:03 字數 685 閱讀 1234

最近往自己的框架裡整合swagger,發現乙個奇怪的問題,當我的tag是中文的時候。發現點選展開不生效,只能點選全部展開,這就十分不方便了。如下圖只能點選expand operations。

第一種方案:如果說我們將tags改為英文,那麼發現介面展開好使。

第二種方案:如果我們不使用tags。直接使用values屬性。value的中文和英文都沒有問題。

但是,第一種方案和第二種方案都不能解決我們的實際問題,因為中文就是為了方便我們檢視這個api是幹什麼用的。所以選擇第三種方案。

網上很多人都說將swagger的版本公升級到2.9.0可以解決問題。我也這麼嘗試了一下,但是不行。報錯如下:

swagger failed to load api definition。

想了一下原理無非是公升級版本,於是將我當前的2.6.0版本公升級到2.7.0。

問題完美解決。

第三種方案:

公升級到2.7.0版本。

swagger2的介面文件

以前見過乙個swagger2的介面文件,特別好用,好看,對介面中入參描述的很詳細 適合用於專案的開發 後來自己做專案的時候,沒有找到這個swagger版本 io.springfox springfox swagger2 2.9.2 io.springfox springfox swagger ui ...

工具 Swagger2寫介面注釋

作為一名coder,經常需要向別人提供介面,或者呼叫別人的介面。於是就有了介面引數是什麼意思,要怎麼傳引數,返回值是什麼意思 有多少呼叫方,就會有多少人來詢問這些引數。如果是長時間之後,自己或許都不知道這些引數是什麼意思。於是維護介面文件便成了一項必不可少的工作,維護文件也有很多問題 swagger...

swagger2 生成介面文件步驟

匯入jar包 swagger2 io.springfox groupid springfox swagger2 artifactid dependency 防止進入swagger頁面報型別轉換錯誤,排除2.9 2中的引用,手動增加1.5 21版本 io.swagger groupid swagger...