解決swagger2.9.2接口文檔顯示的問題
swagger2.9.2接口文檔顯示
swagger版本:2.9.2
框架:springboot2.1.2
當沒有使用
@ApiImplicitParam和response=Resp.class時,swagger會自動去顯示接口入參對象的各屬性,及響應的對象屬性,如下圖:



而如果加入@ApiImplicitParam和response=Resp.class時,則沒有任務字段屬性顯示,如下:

所以建議,當接口的入參為幾個字段屬性時可以加上@ApiImplicitParam進行描述,如果是對象,則只要在該 VO對象用@ApiModel和@ApiModelProperty進行注解后,在接口方法上就不需要加@ApiImplicitParam了,swagger會自動進行解析。

Spring Boot整合swagger2.9.2版本出現的小問題
訪問接口文檔地址時,單個應用能正常訪問swagger-ui.html頁面
但F12看到請求接口有報錯:

但因為在gateway網關進行了各個服務的接口文檔聚合,所以在gateway訪問時一直報錯,因此最后只能降版本,講到Swagger2.8.0版本。
然后請求時相比2.9.2版本少了兩個請求:

這算是2.9.x版本的一個小問題吧,可以看github提交的問題
以上為個人經驗,希望能給大家一個參考,也希望大家多多支持腳本之家。
相關文章
Java的ConcurrentLinkedQueue源碼分析
這篇文章主要介紹了Java的ConcurrentLinkedQueue源碼分析,ConcurrentLinkedQueue 是一個基于鏈接節(jié)點的無界線程安全的隊列,當我們添加一個元素的時候,它會添加到隊列的尾部,當我們獲取一個元素時,它會返回隊列頭部的元素,需要的朋友可以參考下2023-12-12
springboot整合shardingsphere和seata實現分布式事務的實踐
本文主要介紹了springboot整合shardingsphere和seata實現分布式事務的實踐,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧2022-07-07
SpringMVC接收java.util.Date類型數據的2種方式小結
這篇文章主要介紹了使用SpringMVC接收java.util.Date類型數據的2種方法,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教2021-08-08
Java 實戰(zhàn)項目錘煉之樸素風格個人博客系統(tǒng)的實現流程
讀萬卷書不如行萬里路,只學書上的理論是遠遠不夠的,只有在實戰(zhàn)中才能獲得能力的提升,本篇文章手把手帶你用Java+vue+Springboot+ssm+mysql+maven+redis實現一個樸素風格的個人博客系統(tǒng),大家可以在過程中查缺補漏,提升水平2021-11-11
一文詳解SpringBoot如何使用pageHelper做分頁處理
分頁是常見大型項目都需要的一個功能,PageHelper是一個非常流行的MyBatis分頁插件,下面就跟隨小編一起來了解下SpringBoot是如何使用pageHelper做分頁處理的吧2025-03-03

