在CentOS上調試Swagger可參考以下步驟：
一、安裝與部署
- 安裝依賴：安裝Node.js、npm、Java、Maven等基礎環境。
- 部署Swagger UI：
- 手動部署：下載Swagger UI壓縮包，解壓后通過Web服務器（如Nginx/Apache）配置訪問路徑。
- Docker部署：拉取
swaggerapi/swagger-ui鏡像并運行容器，映射端口至主機。
- 部署Swagger Editor：通過Docker運行編輯器容器，或手動安裝后配置Web服務器。
二、配置與測試
- 配置API文檔：
- 將Swagger JSON/YAML文件放置于指定目錄，修改Swagger UI的
index.html中url參數指向該文件。
- 若為Spring Boot項目，可通過
@EnableSwagger2注解配置文檔路徑。
- 測試API接口：
- 在Swagger UI中點擊“Try it out”按鈕直接測試接口，查看請求響應。
- 結合Postman導入Swagger文檔進行更復雜的測試。
三、調試技巧與工具
- 日志分析：查看應用日志（如Spring Boot日志或容器日志），過濾Swagger相關錯誤信息。
- 網絡調試：使用
curl測試API端點，檢查請求參數和響應是否正確。
- 驗證工具：用
swagger-cli或OpenAPI Validator驗證JSON/YAML文件格式是否合規。
- 性能監控：通過Prometheus等工具監控API性能，設置健康檢查端點。
四、常見問題解決
- 無法訪問：檢查服務是否運行、端口是否開放，防火墻設置是否正確。
- 文檔加載失敗：驗證JSON/YAML文件路徑和格式，確保配置的URL可訪問。
- 跨域問題：在Swagger配置中添加CORS支持，或在Nginx中配置反向代理。
參考資料：[1,2,3,5,6,7,8,9,10,11]
