Files
eip4-platform/docs/C3压测基线.md
zhengwr c2b3c5004f docs: 技术文档随仓库——架构设计/迁移手册/C3基线/C5报告迁入 docs/
文档分层:随代码演进的技术文档入 git(团队 clone 可得、有版本与评审);
决策档案与含商务内容的治理文档留工作区 docs/(不随仓库分发,外包 clone 不携带)。
全部交叉引用已更新(README×2/实测报告×2/登记表/pom/ArchUnit 注释)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-11 11:26:44 +08:00

6.3 KiB
Raw Blame History

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

三、归因分析(基线的核心价值)

  1. 延迟按列类型复杂度分两档:仅基础类型列的实体(ORDERLINE/ORDER)P95≈56–63ms;含枚举/引用/布尔列的实体 P95≈117–125ms,约 2 倍差距。对照组同样呈现(26ms vs 52ms)。印证 C1 报告坑 1——引擎对 BOOLEAN/ENUMERATE/引用列每行回调字典查询(getEnumerateItems → SELECT SYS_ENUMERATE),这是《架构设计》(docs/架构设计.md)第五节「元数据反复读 → Caffeine 缓存」改造点的直接量化证据。
  2. 并发超过连接池容量后,P95 主体是排队:并发 10 / 池 5 时,ORDERLINE P95 从 26→56ms、ALLTYPE 从 52→121ms(均 ≈2.2 倍)。生产部署须按预期并发定容连接池,这是配置项;基线对比时务必固定 并发≤池容量 的口径。
  3. 吞吐瓶颈同源:复杂实体 RPS 恒定在 ~115(并发 4 和 10 一样),说明瓶颈在引擎单请求 CPU/字典查询,不在连接数——加池不解决,缓存才解决。
  4. 本基线是 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 改造优先级的直接输入)

  1. 首页延迟与表行数强相关(6.7k 行 22ms → 34k 行 923ms → 38k 行复杂视图 4.2s,P50 口径):每个 list 请求都含全表 count + 无索引扫描/排序 + 每页全量重算,放大了「动态表无索引 + 计划缓存不可复用」两笔税。架构第五节的 DDL 索引增强 + 参数化改造,优先验证对象就是 HR_ATTENDLOG / PM_CONTRACTBALANCE / PM_PAYMENTAPPLY 这一档。
  2. 大文本列(GB_WORKER 照片)抬高传输/物化成本:行数不大(13.7k)但 P50 达 259ms,印证 SqlRowSet 全量物化税(第五节「大结果集流式」改造点)。
  3. 决策会风险 R2(单请求延迟)有了真实锚点:旧系统跑同样的 SQL(引擎同源),这些数字大概率与旧系统同档——待 C1 录制切面部署后采集旧系统侧同口径对照,才能下「打平」结论。
  4. 共享副本噪声:他方查询并发存在,本表为「带噪基线」;切流前在隔离准生产环境复测一轮作为正式 SLA 锚点。

C3 双口径(本地自举 + 客户库真实数据)至此齐备,通过标准达成。