Linux上Swagger接口如何测试

2025年9月12日 互联网

在Linux上测试Swagger接口可通过以下方式操作：

一、手动测试

  1. Swagger UI界面测试

    • 通过Docker部署Swagger UI： 
      docker pull swaggerapi/swagger-ui:v4.15.5  
docker run -d -p 38081:8080 swaggerapi/swagger-ui:v4.15.5

      访问 http://localhost:38081，在界面中找到接口，点击“TRY IT OUT”输入参数测试。

    • 直接通过浏览器访问接口文档URL（需提前部署）：
      http://<服务器地址>/swagger-ui.html。

  2. 命令行工具测试

    • 使用curl发送HTTP请求： 
      # GET请求示例  
curl -X GET "http://localhost:8080/api/users?id=1"  
# POST请求示例  
curl -X POST -H "Content-Type: application/json" -d '{"name":"test"}' http://localhost:8080/api/users  
```。

二、自动化测试

  1. 脚本工具测试

    • 使用swagger-hacker.py等脚本快速探测接口： 
      python swagger-hacker.py -u http://localhost:8080/v2/api-docs  
```。
    • 结合Python requests库编写自动化脚本，结合pytest断言验证响应。

  2. 专业工具集成

    • 导入Swagger文档至SoapUI/Postman，进行接口自动化测试。
    • 使用JMeter等工具对接口进行压力测试。

三、注意事项

  • 确保接口权限正确，避免未授权访问。
  • 测试时优先使用Mock数据，避免依赖外部服务。
最新文章