gaokao-volunteer-system/reports/perf/T11.1_PERF_REPORT.md

T11.1 性能基准报告

日期：2026-06-12 仓库：/home/long/project/gaokao-volunteer-system 目标：T6.1 FastAPI 管理后台骨架

1. 测试范围

使用 locustfile.py 对以下端点进行 10 并发基准：

• POST /api/auth/login
• GET /api/auth/me
• GET /api/meta
• GET /api/orders
• GET /api/orders/{id}（404 视为成功路径）
• GET /api/stats/orders
• GET /health

用户模型：

• AdminBrowseUser：已登录后台浏览用户
• LoginBurstUser：登录高峰用户

2. 测试环境

• Python: 3.11.13
• Locust: 2.42.4
• 服务启动命令：python3 -m admin.app --host 127.0.0.1 --port 18081
• 测试命令：locust -f locustfile.py --host http://127.0.0.1:18081 --headless -u 10 -r 2 -t 30s --csv reports/perf/t11_1
• 数据库：/home/long/project/gaokao-volunteer-system/.tmp/t11_1_admin.db
• JWT secret：本地临时测试值（64 个 x）

3. 发现与修复

首次执行失败，根因是 AuthenticatedHttpUser 作为基类未标记为抽象类，Locust 会把它当成可实例化用户，导致：

• 异常：No tasks defined on AuthenticatedHttpUser
• 结果：进程退出码 1，压测结果不可信

已修复：

• locustfile.py 中为 AuthenticatedHttpUser 增加 abstract = True

修复后重新执行，压测正常结束，failures.csv 与 exceptions.csv 均为空。

4. 结果摘要

总体：

• 总请求数：327
• 失败数：0
• 错误率：0.00%
• 平均吞吐：11.27 req/s
• 聚合中位延迟：2 ms
• 聚合平均延迟：4.62 ms
• 聚合 P95：27 ms
• 聚合 P99：36 ms
• 聚合最大值：43.53 ms

分端点：

端点	请求数	失败	平均延迟(ms)	P95(ms)	最大(ms)	吞吐(req/s)
POST /api/auth/login	27	0	28.53	38	43.53	0.93
GET /api/auth/me	71	0	2.52	3	4.49	2.45
GET /api/meta	55	0	2.38	3	3.37	1.90
GET /api/orders	105	0	2.51	3	4.44	3.62
GET /api/orders/{id} [404]	15	0	2.61	4	3.98	0.52
GET /api/stats/orders	44	0	2.51	3	4.19	1.52
GET /health	10	0	1.77	2	2.04	0.34

5. 结论

结论：在本地单机、10 并发、30 秒 headless Locust 基准下，T6.1 管理后台骨架表现稳定，0 失败，所有 GET 路由 P95 ≤ 4ms，登录接口 P95 为 38ms，满足“先建立可压测基线”的 T11.1 目标。

当前限制：

• 这是本地 SQLite + 单进程 uvicorn 基线，不代表生产容量上限。
• 当前业务仍是 T6.1 骨架，/api/orders、/api/stats/orders 返回占位数据；后续真实业务逻辑接入后需重跑基准。
• 当前测试时长为 30 秒，适合基线验证；若要做发布前容量评估，建议补 5 分钟持续压测与更高并发阶梯测试。

6. 产物

• locustfile.py
• reports/perf/T11.1_PERF_REPORT.md
• reports/perf/t11_1_stats.csv
• reports/perf/t11_1_stats_history.csv
• reports/perf/t11_1_failures.csv
• reports/perf/t11_1_exceptions.csv