demo/BATCH_TEST_API.md

批量测试API文档

这些API用于快速生成大量模拟请求，用来测试日志系统、压力测试等场景。

订单服务测试API

1. 生成一条随机订单

URL:

GET http://localhost:8080/api/test/order

示例:

curl http://localhost:8080/api/test/order | jq .

响应:

{
  "code": 0,
  "msg": "success",
  "data": {
    "orderId": "ORD-A1B2C3D4",
    "userId": "alice-5234",
    "price": 234.56,
    "status": "CREATED",
    "description": "二手家电处理",
    "createdAt": 1707200445123
  }
}

---

2. 批量生成订单

URL:

GET http://localhost:8080/api/test/order/batch?count=50
GET http://localhost:8080/api/test/order/batch (默认10个)

参数:

• count (可选): 要生成的订单数量，默认10个

示例:

# 生成10个订单
curl http://localhost:8080/api/test/order/batch | jq .

# 生成50个订单
curl http://localhost:8080/api/test/order/batch?count=50 | jq .

# 生成100个订单
curl http://localhost:8080/api/test/order/batch?count=100 | jq .data.stats

响应:

{
  "code": 0,
  "msg": "success",
  "data": {
    "total": 10,
    "success": 10,
    "error": 0,
    "duration": 1245,
    "orders": [
      {...订单数据...}
    ]
  }
}

---

3. 场景测试 (创建→查询→支付→删除失败)

URL:

GET http://localhost:8080/api/test/order/scenario?count=5

参数:

• count (可选): 测试轮数，默认5轮

说明: 每轮测试都会:

1. 创建一个订单
2. 查询订单详情
3. 标记订单为已支付
4. 尝试删除订单（预期失败，因为已支付）

这样可以在日志中看到完整的业务流程和错误处理。

示例:

curl http://localhost:8080/api/test/order/scenario?count=3 | jq .

响应:

{
  "code": 0,
  "msg": "success",
  "data": {
    "scenario": "create -> query -> pay -> delete(fail)",
    "rounds": 3,
    "operations": 12,
    "duration": 687
  }
}

---

4. 压力测试

URL:

GET http://localhost:8080/api/test/order/stress?duration=10

参数:

• duration (可选): 测试持续时间（秒），默认10秒

说明: 不间断地创建订单，持续指定时间，用来测试系统吞吐量和日志系统性能。

示例:

# 10秒压力测试
curl http://localhost:8080/api/test/order/stress?duration=10 | jq .

# 30秒压力测试
curl http://localhost:8080/api/test/order/stress?duration=30 | jq .

响应:

{
  "code": 0,
  "msg": "success",
  "data": {
    "duration": 10234,
    "requests": 547,
    "success": 547,
    "error": 0,
    "qps": "53.50"
  }
}

---

支付服务测试API

1. 生成一条随机支付

URL:

GET http://localhost:8080/api/test/payment

示例:

curl http://localhost:8080/api/test/payment | jq .

响应:

{
  "code": 0,
  "msg": "success",
  "data": {
    "paymentId": "PAY-X1Y2Z3W4",
    "orderId": "ORD-123456",
    "amount": 234.56,
    "status": "SUCCESS",
    "paymentMethod": "WECHAT",
    "paidAt": 1707200500234
  }
}

---

2. 批量生成支付

URL:

GET http://localhost:8080/api/test/payment/batch?count=50

参数:

• count (可选): 要生成的支付数量，默认10个

示例:

curl http://localhost:8080/api/test/payment/batch?count=20 | jq .

响应:

{
  "code": 0,
  "msg": "success",
  "data": {
    "total": 20,
    "success": 14,
    "error": 6,
    "totalAmount": 3245.67,
    "duration": 2341,
    "payments": [...]
  }
}

---

3. 退款场景测试

URL:

GET http://localhost:8080/api/test/payment/refund?count=5

参数:

• count (可选): 测试轮数，默认5轮

说明: 每轮测试都会:

1. 创建一个支付
2. 尝试退款

用来测试退款失败的场景（10%失败率）。

示例:

curl http://localhost:8080/api/test/payment/refund?count=10 | jq .

---

4. 支付压力测试

URL:

GET http://localhost:8080/api/test/payment/stress?duration=10

示例:

curl http://localhost:8080/api/test/payment/stress?duration=15 | jq .

---

使用场景

场景1: 快速验证日志格式

# 生成一条订单，查看日志
curl http://localhost:8080/api/test/order

# 查看后端Terminal的JSON日志输出
# 验证 traceId、uri_group、event_class、duration 等字段

场景2: 生成足够的日志用于测试

# 生成100条订单
curl http://localhost:8080/api/test/order/batch?count=100

# 生成50笔支付
curl http://localhost:8080/api/test/payment/batch?count=50

场景3: 测试日志系统的高吞吐处理能力

# 30秒的订单压力测试
curl http://localhost:8080/api/test/order/stress?duration=30

# 30秒的支付压力测试
curl http://localhost:8080/api/test/payment/stress?duration=30

# 查看日志系统是否能正常处理高频请求
# 观察 Duration 字段是否异常增大（说明日志处理成为瓶颈）

场景4: 测试自动异常处理和日志记录

# 场景测试会失败删除已支付订单，产生异常日志
curl http://localhost:8080/api/test/order/scenario?count=10

# 支付服务有30%的失败率，可以看到error日志
curl http://localhost:8080/api/test/payment/batch?count=50

场景5: 批量脚本测试

#!/bin/bash
# 连续运行多个测试

echo "=== 生成10个订单 ==="
curl http://localhost:8080/api/test/order/batch?count=10
echo ""

echo "=== 生成20笔支付 ==="
curl http://localhost:8080/api/test/payment/batch?count=20
echo ""

echo "=== 场景测试5轮 ==="
curl http://localhost:8080/api/test/order/scenario?count=5
echo ""

echo "=== 10秒压力测试 ==="
curl http://localhost:8080/api/test/order/stress?duration=10
echo ""

保存为 batch-test.sh 并运行：

chmod +x batch-test.sh
./batch-test.sh

---

日志观察

运行这些API后，在后端Terminal中观察JSON日志：

{
  "ts":"2024-02-06T10:30:45.123Z",
  "level":"INFO",
  "msg":"测试订单生成成功 orderId=ORD-A1B2C3D4",
  "event_class":"order",
  "status":"success",
  "uri_group":"/test/*",
  "duration":"145",
  "app":"shop-recycle-order-service"
}

关键观察:

• ✅ uri_group 应该是 /test/* (规范化规则自动应用)
• ✅ event_class 应该是 order 或 payment
• ✅ status 应该是 success 或 server_error
• ✅ duration 显示请求耗时
• ✅ 所有日志共享相同的 traceId (如果在同一请求中)

---

PowerShell 一键测试脚本

# run-batch-tests.ps1

Write-Host "=== 订单服务测试 ===" -ForegroundColor Cyan
Write-Host "1. 生成10个订单"
Invoke-WebRequest -Uri "http://localhost:8080/api/test/order/batch?count=10" | ConvertFrom-Json | ForEach-Object { $_.data | Format-Table total,success,error,duration -AutoSize }

Start-Sleep -Seconds 2

Write-Host "2. 场景测试"
Invoke-WebRequest -Uri "http://localhost:8080/api/test/order/scenario?count=5" | ConvertFrom-Json | ForEach-Object { $_.data | Format-Table scenario,rounds,duration -AutoSize }

Start-Sleep -Seconds 2

Write-Host ""
Write-Host "=== 支付服务测试 ===" -ForegroundColor Green
Write-Host "3. 生成20笔支付"
Invoke-WebRequest -Uri "http://localhost:8080/api/test/payment/batch?count=20" | ConvertFrom-Json | ForEach-Object { $_.data | Format-Table total,success,error,totalAmount,duration -AutoSize }

Write-Host ""
Write-Host "✅ 测试完成!" -ForegroundColor Green
Write-Host "查看后端Terminal的JSON日志输出"

---

所有这些API都会生成完整的结构化JSON日志，便于验证日志系统的正确性。