文档分层:随代码演进的技术文档入 git(团队 clone 可得、有版本与评审); 决策档案与含商务内容的治理文档留工作区 docs/(不随仓库分发,外包 clone 不携带)。 全部交叉引用已更新(README×2/实测报告×2/登记表/pom/ArchUnit 注释) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
6.3 KiB
C3 压测基线 v1(M0 交付物)
版本 v1.0(2026-06-10)| 工具:
eip4-platform/tools/loadtest/load_p95.py(零依赖,可复跑) 环境:本地自举环境——eip4-platform(profile=local,单实例,HikariCP max=5,日志 INFO)+ PG 15(localhost:5433/eip4m0),M2 Mac 数据规模:每实体 50 行(子表 EIP4PT_ORDERLINE 108 行),C1 自举种子(固定随机种子可复现) 口径:GET /api/entity/{t}/list?page=1&perPage=20,每实体预热 3 次后 300 请求
一、主基线(并发 10)
| 实体 | P50(ms) | P90(ms) | P95(ms) | P99(ms) | Max(ms) | RPS | 错误 |
|---|---|---|---|---|---|---|---|
| EIP4PT_ORDERLINE(子表,108行) | 37.0 | 51.9 | 56.3 | 65.2 | 69.5 | 247.4 | 0 |
| EIP4PT_ORDER(主表) | 42.3 | 58.8 | 62.9 | 66.1 | 76.5 | 224.7 | 0 |
| EIP4PT_EMPLOYEE | 81.7 | 117.4 | 121.7 | 130.4 | 141.2 | 114.5 | 0 |
| EIP4PT_CUSTOMER | 82.9 | 111.3 | 118.7 | 134.8 | 143.2 | 115.3 | 0 |
| EIP4PT_PRODUCT | 80.9 | 110.3 | 116.4 | 133.8 | 139.5 | 115.8 | 0 |
| EIP4PT_CONTRACT | 81.3 | 111.7 | 117.3 | 126.3 | 136.6 | 115.6 | 0 |
| EIP4PT_INVOICE | 83.2 | 112.9 | 122.4 | 134.2 | 147.8 | 113.3 | 0 |
| EIP4PT_ALLTYPE(全显示类型) | 80.2 | 111.2 | 120.7 | 138.8 | 146.5 | 114.5 | 0 |
| EIP4PT_DEVICE | 80.6 | 111.9 | 121.0 | 135.8 | 139.7 | 115.7 | 0 |
| EIP4PT_PROJECT | 82.1 | 112.3 | 124.5 | 132.0 | 153.1 | 114.1 | 0 |
原始数据:
eip4-platform/tools/loadtest/baseline-local-20260610.json。10 实体 × 300 请求全程 0 错误。
二、对照组(并发 4,连接池内)
| 实体 | P95(ms) | P99(ms) | RPS |
|---|---|---|---|
| EIP4PT_ORDERLINE | 26.2 | 28.3 | 230.4 |
| EIP4PT_ORDER | 26.3 | 27.8 | 233.1 |
| EIP4PT_ALLTYPE | 52.1 | 58.0 | 117.5 |
原始数据:
baseline-local-c4-20260610.json
三、归因分析(基线的核心价值)
- 延迟按列类型复杂度分两档:仅基础类型列的实体(ORDERLINE/ORDER)P95≈56–63ms;含枚举/引用/布尔列的实体 P95≈117–125ms,约 2 倍差距。对照组同样呈现(26ms vs 52ms)。印证 C1 报告坑 1——引擎对 BOOLEAN/ENUMERATE/引用列每行回调字典查询(getEnumerateItems → SELECT SYS_ENUMERATE),这是《架构设计》(docs/架构设计.md)第五节「元数据反复读 → Caffeine 缓存」改造点的直接量化证据。
- 并发超过连接池容量后,P95 主体是排队:并发 10 / 池 5 时,ORDERLINE P95 从 26→56ms、ALLTYPE 从 52→121ms(均 ≈2.2 倍)。生产部署须按预期并发定容连接池,这是配置项;基线对比时务必固定 并发≤池容量 的口径。
- 吞吐瓶颈同源:复杂实体 RPS 恒定在 ~115(并发 4 和 10 一样),说明瓶颈在引擎单请求 CPU/字典查询,不在连接数——加池不解决,缓存才解决。
- 本基线是 P2「渐进参数化 + Caffeine」改造收益的对照原点:改造后同口径复测,期望复杂实体向简单实体档位收敛。
四、诚实边界与待办
| 边界 | 说明 | 待办 |
|---|---|---|
| 数据规模 | 每实体 50 行,远小于客户库真实表 | 5435 网络恢复后在副本上以真实数据重跑 |
| Top10 口径 | 生产访问日志不可得,以 C1 种子实体代理(覆盖全部显示类型与主子表) | 切流前用 Nginx 访问日志统计真实 Top10 重跑 |
| 环境 | M2 Mac 单机,非交付形态(4 进程 docker-compose) | 检查点①前在准生产环境复测 |
| 决策会风险 R2(单请求延迟) | 旧系统侧无对照数据,「打平与否」尚不可答 | C1 录制切面部署旧系统后同口径采集对照 |
结论:C3 通过标准「出 P95 延迟基线文档」已达成(本地口径,含归因);客户库口径复测列为遗留动作。
五、复跑命令
# 1) 起服务
cd eip4-platform && mvn spring-boot:run -pl platform-app -Dspring-boot.run.profiles=local
# 2) 压测
cd eip4-platform/tools/loadtest
python3 load_p95.py --base http://localhost:8084 \
--entities EIP4PT_ORDERLINE,EIP4PT_ORDER,... --requests 300 --concurrency 10 \
--out-md 基线.md --out-json 基线.json
【2026-06-11 增补】客户库口径基线(5435 网络恢复后实测)
环境:同一 eip4-platform 实例连客户库副本(192.168.20.68:5435,共享副本,测时有他方活跃查询,数字含噪声) 口径:page=1&perPage=20,预热 3 次,150 请求/实体,并发 4(与本地对照组同口径);重实体单列 30 请求/并发 2
| 实体 | 表行数 | P50(ms) | P95(ms) | P99(ms) | RPS | 错误 |
|---|---|---|---|---|---|---|
| SYS_HZPY | 6,727 | 22.2 | 78.9 | 107.1 | 143.7 | 0 |
| OA_FILESENDUSER | 40,983 | 28.5 | 113.3 | 115.3 | 111.6 | 0 |
| PM_BUILDERSDIARY | 9,210 | 42.2 | 129.1 | 132.5 | 74.9 | 0 |
| OA_SEALUSEAPPLY | 10,751 | 49.1 | 134.7 | 139.5 | 64.0 | 0 |
| PM_PROJECT_TASK | 17,674 | 72.2 | 160.2 | 189.3 | 46.2 | 0 |
| GB_WORKER(照片大列) | 13,697 | 258.8 | 363.5 | 517.6 | 15.0 | 0 |
| PM_CONTRACTBALANCE | 34,774 | 299.9 | 465.2 | 530.9 | 12.1 | 0 |
| HR_ATTENDLOG | 33,766 | 923.3 | 1,179.8 | 1,322.3 | 4.1 | 0 |
| PM_PAYMENTAPPLY(DISTINCT+4 LATERAL) | 38,138 | 4,192.9 | 4,630.0 | 4,649.2 | 0.5 | 0 |
原始数据:eip4-platform/tools/loadtest/baseline-real-20260611.json + baseline-real-heavy-20260611.json。全程 0 错误。
客户库口径归因(对 P2 改造优先级的直接输入)
- 首页延迟与表行数强相关(6.7k 行 22ms → 34k 行 923ms → 38k 行复杂视图 4.2s,P50 口径):每个 list 请求都含全表 count + 无索引扫描/排序 + 每页全量重算,放大了「动态表无索引 + 计划缓存不可复用」两笔税。架构第五节的 DDL 索引增强 + 参数化改造,优先验证对象就是 HR_ATTENDLOG / PM_CONTRACTBALANCE / PM_PAYMENTAPPLY 这一档。
- 大文本列(GB_WORKER 照片)抬高传输/物化成本:行数不大(13.7k)但 P50 达 259ms,印证 SqlRowSet 全量物化税(第五节「大结果集流式」改造点)。
- 决策会风险 R2(单请求延迟)有了真实锚点:旧系统跑同样的 SQL(引擎同源),这些数字大概率与旧系统同档——待 C1 录制切面部署后采集旧系统侧同口径对照,才能下「打平」结论。
- 共享副本噪声:他方查询并发存在,本表为「带噪基线」;切流前在隔离准生产环境复测一轮作为正式 SLA 锚点。
C3 双口径(本地自举 + 客户库真实数据)至此齐备,通过标准达成。