如何用Ubuntu進行Swagger測試

在Ubuntu上進行Swagger測試，可按以下步驟操作，主要通過安裝Swagger工具、配置API文檔并執行測試：

一、安裝基礎環境

1. 安裝Node.js和npm

   sudo apt update  
   sudo apt install -y nodejs npm  
   

二、安裝Swagger工具

方式1：使用npm安裝（推薦）

• 安裝Swagger UI

  sudo npm install -g swagger-ui-express  
  

• 安裝Swagger Editor（可選，用于編輯文檔）

  sudo npm install -g swagger-editor  
  

方式2：使用Docker安裝

• 拉取Swagger UI鏡像

  sudo apt install docker.io  
  docker pull swaggerapi/swagger-ui  
  

• 運行容器（掛載本地Swagger文件）

  docker run -p 8080:8080 -v /path/to/swagger.yaml:/app/swagger.yaml swaggerapi/swagger-ui  
  

  訪問 http://localhost:8080 即可查看。

三、配置Swagger文檔

1. 創建swagger.yaml或swagger.json
   示例（swagger.yaml）：

   swagger: '2.0'  
   info:  
     title: Sample API  
     version: 1.0.0  
   paths:  
     /users:  
       get:  
         summary: List all users  
         responses:  
           200:  
             description: User list  
   

2. 集成到Express應用（可選）

   const express = require('express');  
   const swaggerUi = require('swagger-ui-express');  
   const YAML = require('yamljs');  
   const app = express();  
   const swaggerDocument = YAML.load('./swagger.yaml');  
   app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument));  
   app.listen(3000, () => console.log('Server running on port 3000'));  
   

   啟動后訪問 http://localhost:3000/api-docs。

四、執行測試

1. 通過Swagger UI測試

   • 訪問 http://localhost:3000/api-docs，找到目標接口，點擊“Try it out!”。
   • 輸入參數后點擊“Execute”，查看響應結果。

2. 自動化測試（結合工具）

   • 使用Python + pytest：通過requests庫發送HTTP請求，結合pytest斷言結果。
   • 使用JMeter：導入Swagger文檔生成測試腳本，模擬多場景請求。

五、可選：兼容性測試

• 多瀏覽器測試：通過Docker運行不同瀏覽器的Selenium容器，驗證Swagger UI兼容性。
• 在線工具：使用BrowserStack等模擬器測試不同環境。

注意事項

• 確保swagger.yaml/swagger.json語法正確，可通過swagger-cli驗證。
• 若需測試后端服務，需確保服務已啟動并與Swagger文檔路徑一致。

以上步驟參考自，可根據實際需求選擇工具和方法。