swagger使用過程中遇到的坑

2022-07-29 02:30:18 字數 1914 閱讀 1741

1、無限請求

如果swagger頁面請求有錯誤,swagger會無限嘗試訪問,後面重啟專案的時候,控制層會無限重新整理出現日誌的內容

本地的好辦,如果專案專案部署到伺服器中,可能十幾分鐘產生幾個g的日誌檔案

解決方式:最簡單的方式——關閉請求報錯的瀏覽器

2、同名問題

@api(同名的問題) 因為swagger會根據tags 的名稱查詢物件,有同名物件的時候,swagger的文件就會出現問題

如果swagger的某個api下出現不屬於該api的請求,這個就是api的同名的問題,查詢相同的api名稱替換即可

3、類上的註解「/」的問題

@apimodel(不能使用「/」)

errors

hide

resolver error at paths./v1-0/configuration/add.post.parameters.1.schema.properties.listhotcarbrandivo.items.$ref

could not resolve reference because of: could not resolve pointer: /definitions/熱門車/品牌/的ivo does not exist in document

4、使用map作為返回型別報錯,

errors

hide

resolver error at definitions.map«string,list«賣車車輛資訊ovo»».additionalproperties.$ref

could not resolve reference because of: could not resolve pointer: /definitions/list does not exist in document

兩個解決方案:公升級swagger版本號,這個是我用2.8.0報錯會報錯,網上有說公升級版本可以解決,這個我沒有去試,

io.springfox

springfox-swagger2

2.8.0

我這邊的解決方案是,將map定義在物件中,物件導向程式設計,而且這樣生成文件的時候,注釋也會顯示好

5、swagger版本的問題,2.8之前的版本在  路徑/ +@pathvarisble這樣的寫法

2.8之前,swagger給出的型別居然是body,需要用json的格式傳這個很奇怪,

版本更新到2.8以後,路徑後面繫結的引數就是swagger給出的型別居然是就能是param

適當的更新版本有好處

io.springfox

springfox-swagger2

2.8.0

io.springfox

springfox-swagger-ui

2.8.0

6沒有重現過的乙個bug

failed to execute 'fetch' on 'window': failed to parse url from http://localhost/8765undefindfailed to parse url from http://localhost/8765undefind
我一直重啟專案 swagger沒有重現問題

後來我修改請求你方法上的api注釋,重啟就可以,可能是swagger上api衝突,關鍵是這個沒有提示,好暈;如果誰找到重現這個問題來說一下

Spring data Jpa使用過程中遇到的坑

一定要注意如果我們在實體類中沒有配置資料表的預設值,那麼在存入和取出的時候應該設定。否則在取出的時候就會出現問題。如何通過一方獲取到多方實體 jsp中 jsp資料夾與上面servlet對映名最好不要一致,這樣會出問題 注意!乙個實體類的表id名字請設定為id,保證不出錯。問題分析 解決方法 其實一般...

Glide使用過程中遇到的坑

專案之前使用的載入庫是universal image loader,但是此庫已經好久不維護了,同時也發現了更加不錯的載入庫,也就是glide,用起來很方便並且記憶體佔用量還很令人滿意,所以決定大刀闊斧的將之前的載入庫換成glide。但是在換使用者頭像相關模組的時候發現問題了,就是載入網路時第一次載入...

mysql 使用過程中遇到的錯誤

修改hibernate.cfg.xml檔案 hibernate.connection.url jdbc mysql localhost 3306 hibernatedemo connection.useunicode true connection.characterencoding utf 8 參...