如何利用Swagger进行Linux API测试

如何在Linux环境下利用Swagger进行API测试

一、前置准备：安装Swagger工具

在Linux系统中，Swagger的测试流程需依赖以下工具，推荐通过Docker（环境隔离、易部署）或手动安装（灵活定制）完成：

Docker部署（推荐）
- 安装Docker：sudo apt update && sudo apt install -y docker.io && sudo systemctl start docker && sudo systemctl enable docker
- 拉取Swagger镜像：
  - Swagger Editor（在线编辑API文档）：docker pull swaggerapi/swagger-editor:v4.6.0
  - Swagger UI（可视化测试界面）：docker pull swaggerapi/swagger-ui:v4.15.5
- 运行容器：
  - Swagger Editor：docker run -d -p 38080:8080 swaggerapi/swagger-editor:v4.6.0
  - Swagger UI：docker run -d -p 38081:8080 swaggerapi/swagger-ui:v4.15.5
- 访问地址：浏览器打开http://<服务器IP>:38080（Editor）或http://<服务器IP>:38081（UI）。
手动安装（可选）
- 安装Node.js和npm：sudo apt install -y nodejs npm
- 全局安装Swagger Editor/UI：npm install -g swagger swagger-ui
- 启动服务：swagger-editor http-server -p 8080（Editor）、swagger-ui http-server -p 8081（UI）。

二、配置Swagger文档

API测试的前提是有规范的OpenAPI文档（支持YAML/JSON格式），需包含接口路径、参数、请求方法、响应结构等信息：

创建文档：在项目目录下新建swagger.yaml（或swagger.json），示例如下：

swagger: '2.0' info: title: Linux API测试示例 version: 1.0.0 basePath: /api/v1 paths: /user/{id}: get: summary: 获取用户信息 parameters: - name: id in: path required: true type: integer responses: '200': description: 成功返回用户信息 schema: type: object properties: id: type: integer name: type: string

启动Swagger Editor：将文档导入Editor（点击左上角File→Import File），实时校验文档语法和完整性。

三、使用Swagger UI进行可视化测试

Swagger UI是Linux下最常用的交互式测试工具，无需编写代码即可快速验证接口：

导入文档：打开Swagger UI（http://<服务器IP>:38081），点击Import按钮，选择swagger.yaml文件。
测试接口：
- 在左侧菜单找到目标接口（如/user/{id}），点击展开。
- 点击右侧Try it out按钮，输入必填参数（如id: 1）。
- 点击Execute，下方会显示请求URL、响应状态码（如200）、响应体（如{"id":1,"name":"张三"}）和响应时间。

四、使用命令行工具进行自动化测试

若需批量测试或集成到CI/CD流程，可使用命令行工具实现自动化：

Swagger Codegen生成测试代码
- 安装Swagger Codegen CLI：wget https://repo1.maven.org/maven2/io/swagger/codegen/v3/swagger-codegen-cli/3.0.44/swagger-codegen-cli-3.0.44.jar -O swagger-codegen-cli.jar
- 生成Python客户端（以swagger.yaml为例）：
  java -jar swagger-codegen-cli.jar generate -i swagger.yaml -l python -o ./generated-client
- 编写测试用例（使用pytest框架）：
```
import pytest from generated_client.api.default_api import DefaultApi def test_get_user(): api = DefaultApi() response = api.get_user_by_id(id=1) assert response.status == 200 
```
- 运行测试：pytest test_api.py。
Postman + Newman CLI
- 将Swagger文档导出为Postman Collection（通过Swagger Editor的Export功能）。
- 安装Newman：npm install -g newman
- 运行测试：newman run your-collection.json（支持生成HTML报告：newman run your-collection.json -r html）。
Dredd（OpenAPI规范测试工具）
- 安装Dredd：npm install -g dredd
- 运行测试：dredd swagger.yaml http://localhost:8080（Dredd会根据文档中的请求/响应结构，自动调用API并比对结果）。

五、辅助工具：curl命令行测试

若不想依赖图形界面或第三方工具，可直接用Linux自带的curl命令测试接口：

GET请求（参数在URL中）：
curl "http://<服务器IP>:8080/api/v1/user/1"
POST请求（参数在Body中，JSON格式）：
curl -X POST "http://<服务器IP>:8080/api/v1/user/create" -H "Content-Type: application/json" -d '{"name":"李四","age":25}'
POST请求（参数在Body中，表单格式）：
curl -X POST "http://<服务器IP>:8080/api/v1/user/create" -H "Content-Type: application/x-www-form-urlencoded" -d "name=王五&age=30"。

六、安全与优化建议

安全配置：若Swagger UI暴露在公网，需添加密码保护（参考Swagger UI官方文档的securityDefinitions配置）。
性能测试：结合ab（Apache Benchmark）、siege等工具，测试接口的并发性能（如ab -n 1000 -c 100 http://<服务器IP>:8080/api/v1/user/1）。
文档同步：确保Swagger文档与API代码版本一致（如通过Spring Boot集成Swagger2，自动生成文档）。