1. 为什么选择PetStore作为接口测试练手项目

PetStore作为经典的演示项目，在软件测试领域有着特殊的地位。我第一次接触这个项目是在2016年参与一个电商平台的测试工作，当时团队需要快速验证RESTful接口的测试方案。PetStore的完整API文档和可预测的响应模式，让它成为了理想的测试对象。

这个项目特别适合测试新手入门的几个原因：

• 接口设计规范：完全遵循OpenAPI规范（原Swagger），每个端点都有清晰的参数定义
• 业务场景完整：包含用户注册、登录、商品管理、订单处理等典型电商功能
• 环境搭建简单：官方提供docker-compose一键部署方案
• 测试数据明确：宠物分类、状态等字段有固定枚举值

提示：虽然PetStore是演示项目，但其接口设计模式与真实电商系统高度一致。掌握它的测试方法可以直接迁移到商业项目中。

2. 测试环境准备与项目初始化

2.1 本地部署PetStore服务

推荐使用Docker快速搭建测试环境：

# 拉取官方镜像 docker pull swaggerapi/petstore # 启动容器（端口映射可自定义） docker run -d -p 8080:8080 --name petstore swaggerapi/petstore

验证服务是否正常运行：

curl http://localhost:8080/api/v3/pet/findByStatus?status=available

应该返回JSON格式的宠物列表。如果没有响应，检查防火墙是否放行了8080端口。

2.2 初始化测试项目

以Python + pytest为例创建测试框架：

mkdir petstore-test && cd petstore-test python -m venv venv source venv/bin/activate # Linux/Mac venv\Scripts\activate # Windows pip install requests pytest pytest-html allure-pytest

项目目录结构建议：

petstore-test/ ├── tests/ │ ├── __init__.py │ ├── conftest.py # 公共fixture │ ├── test_pet.py # 宠物相关接口 │ └── test_store.py # 订单相关接口 ├── utils/ │ └── api_client.py # 封装请求方法 └── requirements.txt

3. 核心接口测试用例设计

3.1 宠物管理接口测试要点

PetStore的宠物接口(/pet)是典型的CRUD操作，测试时需要特别注意：

1. 创建宠物(POST /pet)

   • 必填字段验证：name、photoUrls不能为空
   • 状态枚举值校验：status只接受available/pending/sold
   • 非法ID检测：id字段应为int64类型

2. 更新宠物(PUT /pet)

   • 更新不存在的宠物时应返回404
   • 部分更新(PATCH)与全量更新的区别
   • 并发修改测试（ETag校验）

示例测试用例：

def test_create_pet_success(api_client): payload = { "name": "doggie", "photoUrls": ["https://example.com/dog.jpg"], "status": "available" } response = api_client.post("/pet", json=payload) assert response.status_code == 200 assert "id" in response.json()

3.2 订单接口的边界测试

/store接口的特别注意事项：

• 库存不足时下单应返回400
• 订单ID的幂等性测试
• 订单状态流转验证（placed → approved → delivered）

建议使用pytest的parametrize进行数据驱动测试：

import pytest @pytest.mark.parametrize("quantity,expected_code", [ (1, 200), # 正常库存 (999, 400), # 超库存 (0, 400), # 零数量 (-1, 400) # 负数 ]) def test_order_quantity_validation(api_client, quantity, expected_code): payload = { "petId": 1, "quantity": quantity, "shipDate": "2023-12-01T00:00:00Z", "status": "placed" } response = api_client.post("/store/order", json=payload) assert response.status_code == expected_code

4. 高级测试策略与实践

4.1 契约测试实施

利用PetStore的OpenAPI文档进行契约验证：

1. 安装prism模拟服务：

npm install -g @stoplight/prism-cli prism mock https://petstore3.swagger.io/api/v3/openapi.json

2. 编写契约测试：

from openapi_core import validate_request def test_api_contract(api_client): request = api_client.prepare_request( method="GET", url="/pet/1" ) result = validate_request(request, spec) assert not result.errors # 验证请求符合规范

4.2 性能测试方案

使用Locust进行压力测试：

from locust import HttpUser, task class PetStoreUser(HttpUser): @task def query_pets(self): self.client.get("/pet/findByStatus?status=available") @task(3) # 权重3倍 def create_order(self): self.client.post("/store/order", json={ "petId": 1, "quantity": 1, "status": "placed" })

关键性能指标建议：

• 单接口TPS不低于200
• 错误率<0.1%
• 95%响应时间<500ms

5. 常见问题排查指南

5.1 跨域问题处理

当出现CORS错误时，检查服务端配置：

# docker-compose.yml环境变量 environment: - SWAGGER_HOST=http://localhost:8080 - SWAGGER_BASE_PATH=/api/v3

5.2 数据持久化问题

PetStore默认使用内存数据库，重启后数据会丢失。如需持久化：

docker run -d -p 8080:8080 -v ./data:/tmp --name petstore swaggerapi/petstore

5.3 接口版本差异

注意v2和v3版本的路径差异：

• v2: /v2/pet
• v3: /api/v3/pet

6. 测试报告与持续集成

6.1 生成HTML测试报告

在pytest.ini中配置：

[pytest] addopts = --html=report.html --self-contained-html

6.2 Jenkins集成示例

Jenkinsfile配置片段：

pipeline { agent any stages { stage('Test') { steps { sh 'python -m pytest tests/' publishHTML target: [ allowMissing: false, alwaysLinkToLastBuild: false, keepAll: true, reportDir: '.', reportFiles: 'report.html', reportName: 'PetStore Test Report' ] } } } }

我在实际项目中总结的几个经验：

1. 对/pet/{petId}接口做fuzz测试时，发现输入超长字符串会导致服务端500错误，这提示我们需要加强参数校验
2. 使用vcr.py录制测试流量，可以大幅提升测试速度并实现离线验证
3. 订单状态的测试要考虑时间因素，比如shipDate不能早于当前时间