test(#94): 性能压测套件 - Locust REST API梯度压测 + WebSocket长连接并发压测(100-5000) + 压测方案文档

2026-08-11 07:07:44 +08:00
parent 0f382ce2d0
commit d5f9efe766
6 changed files with 174 additions and 0 deletions
@@ -0,0 +1,32 @@
+# 性能压测方案（Issue #94）
+
+## 范围
+
+1. **REST API 并发**：Locust 梯度 10/50/100/500/1000 并发，覆盖
+   登录 -> 设备查询 -> 数据上报 -> 报表查询完整路径（`locustfile.py`）
+2. **数据量**：百万级抄表/营收记录下的分页查询与报表聚合（结合 `db/` 种子数据，
+   关注慢查询日志 > 500ms 的语句并补索引）
+3. **WebSocket 长连接**：`websocket_stress.py` 支持 100-5000 并发连接，
+   输出建连成功率与 P50/P95/P99 往返延迟
+
+## 运行
+
+```bash
+pip install locust websockets
+mkdir -p reports
+# REST API（示例：100 并发 5 分钟）
+locust -f tests/performance/locustfile.py --host http://127.0.0.1:8000 \
+       -u 100 --spawn-rate 10 --run-time 5m --headless --html reports/api_100.html
+# WebSocket（示例：500 连接 60 秒）
+python tests/performance/websocket_stress.py --url ws://127.0.0.1:8000/ws \
+       --concurrency 500 --duration 60
+```
+
+## 验收基线（测试环境 2C4G）
+
+| 指标 | 目标 |
+|------|------|
+| API P95 延迟（100 并发） | ≤ 300ms |
+| API 错误率（500 并发） | ≤ 0.5% |
+| WebSocket 500 连接建连成功率 | ≥ 99% |
+| WS 消息 P95 往返 | ≤ 200ms |