本文介紹在Linux系統(tǒng)下調(diào)試Swagger的步驟。

一、安裝Swagger ui和Swagger Editor

首先，需要安裝Swagger UI和Swagger Editor。推薦使用docker安裝Swagger UI，方便快捷。

1. 安裝Swagger UI (Docker): 執(zhí)行以下命令拉取并運(yùn)行Swagger UI鏡像：

   docker pull swaggerapi/swagger-ui:v4.15.5 docker run -d -p 38081:8080 swaggerapi/swagger-ui:v4.15.5

   這將啟動(dòng)一個(gè)Swagger UI容器，并將其8080端口映射到主機(jī)的38081端口。

2. 安裝Swagger Editor (手動(dòng)): Swagger Editor需要手動(dòng)下載靜態(tài)文件，并配置Web服務(wù)器。 使用以下命令下載：

   wget https://cdnjs.cloudflare.com/ajax/libs/swagger-ui/3.50.0/swagger-editor.min.js wget https://cdnjs.cloudflare.com/ajax/libs/swagger-ui/3.50.0/swagger-editor.min.css

   將下載的文件放置到Web服務(wù)器的目錄下（例如/var/www/html），并配置服務(wù)器（apache或nginx）使其可訪問(wèn)。

二、Swagger配置

接下來(lái)，需要配置Swagger UI指向你的API文檔。

1. 配置Swagger UI: 修改Swagger UI的配置文件（通常是index.html），將url參數(shù)指向你的API文檔的URL。例如：

   script src="swagger-editor.js" type="text/javascript">script> window.onload = function() {   const editor = Swaggereditor({     url: "http://your-api-docs-url" // 替換為你的API文檔URL   }); };

三、訪問(wèn)和調(diào)試

1. 訪問(wèn)Swagger UI: 在瀏覽器中訪問(wèn)http://localhost:38081/swagger-ui.html (或你配置的URL)。 你將看到Swagger UI界面，列出可用的API接口。

2. 測(cè)試API接口: 點(diǎn)擊“try IT OUT”按鈕測(cè)試API接口，驗(yàn)證其功能。

四、調(diào)試注意事項(xiàng)

• 檢查容器狀態(tài): 使用docker ps命令檢查Swagger UI容器是否運(yùn)行。
• 端口映射: 確保端口映射正確。
• 安全配置: 根據(jù)需要配置Swagger UI的安全設(shè)置（例如密碼保護(hù)）。

五、使用ide調(diào)試 (可選)

高級(jí)調(diào)試可以使用IDE（如IntelliJ idea或VS Code）進(jìn)行遠(yuǎn)程調(diào)試。 需要在IDE中配置遠(yuǎn)程調(diào)試，連接到Swagger UI容器，設(shè)置斷點(diǎn)，并啟動(dòng)調(diào)試會(huì)話。

通過(guò)以上步驟，你可以在Linux系統(tǒng)上成功部署和調(diào)試Swagger。 如有問(wèn)題，請(qǐng)參考官方文檔。