gongxue-base/docs/refactor/performance-benchmark-summary-20260630.md

真实迁移数据 API 压测摘要

更新时间：2026-07-01

这份文件只记录脱敏后的聚合指标，便于 README、上线门禁和后续 AI 开发继续引用。原始 JSON/Markdown 报告位于已忽略的 docs/refactor/performance-reports/，不要提交到 Git。

测试口径

• 环境：本地 Docker Desktop + 本地 Supabase/PostgreSQL + 本地 API 进程。
• 数据：PocketBase 真实导出数据导入新 PostgreSQL 后压测。
• 数据规模：当前真实迁移库已包含前期压测写入记录，约 74,117 道题、1,601 个题目合集、3,106 个练习蓝图、3,505 个单词、2,678 条知识手册、3,690 个用户、196,846 条答题记录、38,207 条错题和 466 条权益。
• Docker Desktop 资源：当前本机约 20 CPU、62.7GB 内存，高于常见 4 核 16G 云服务器；本地结果只用于观察代码和索引趋势。
• 写入流量：混合场景开启真实刷题闭环，包含创建 session、拉取 session detail、提交若干答案、交卷和读取报告。
• 商城说明：本地库的订单数据会受 seed、烟测和导入演练影响，当前容量结论聚焦题库读写链路，不用于推断 GMV、支付或订单峰值。
• 排行榜：未纳入默认压测，当前产品默认关闭排行榜。
• 说明：压测 worker 是无停顿请求流，不等同于真实在线学生数。真实在线容量需要前端埋点后按单个学生平均 RPS 折算。

结果

120 秒阶梯基线

并发 worker	时长	刷题写入比例	请求数	错误率	吞吐	P95	P99
30	120s	10%	112,896	0.00%	934.74 req/s	64.26 ms	81.14 ms
50	120s	10%	92,737	0.00%	767.24 req/s	121.51 ms	159.12 ms
100	120s	8%	84,608	0.00%	699.27 req/s	254.69 ms	331.84 ms
150	120s	6%	82,693	0.00%	682.40 req/s	369.90 ms	493.69 ms

60 秒复测快照

2026-06-30 晚重新 supabase db reset、导入同一批 PocketBase 真实 JSON 后复跑，pb:import:validate 为 0 failures/3 warnings，pb:import:sample 为 0 failures/6 warnings/1 skipped/39 passed。

并发 worker	时长	刷题写入比例	请求数	错误率	吞吐	P95	P99
30	60s	10%	64,025	0.00%	1052.52 req/s	55.14 ms	70.15 ms
100	60s	8%	59,123	0.00%	969.92 req/s	179.70 ms	235.19 ms
150	60s	6%	53,167	0.00%	870.06 req/s	298.23 ms	402.89 ms

2026-07-01 上线门禁与读写复核

这轮在同一套本地 Docker/Supabase 真实迁移库上执行，补充了只读上线门禁和 50 worker 混合读写复核。

并发 worker	时长	刷题写入比例	请求数	错误率	吞吐	P95	P99	结论
30	120s	0%	108,336	0.00%	897.04 req/s	68.32 ms	84.50 ms	通过只读上线门禁
50	60s	10%	52,979	0.00%	870.42 req/s	104.92 ms	136.22 ms	通过混合读写观察线

2026-07-01 H5 发布烟测后读写复核

本轮在新增 npm run smoke:taro:h5 后复跑，确认后端真实数据读写容量未受前端发布守卫改动影响。压测仍使用本地 Docker/Supabase 真实迁移库，排行榜未纳入默认负载。

并发 worker	时长	刷题写入比例	请求数	错误率	吞吐	P95	P99	结论
50	60s	10%	51,425	0.00%	845.06 req/s	110.39 ms	138.79 ms	通过混合读写观察线
100	60s	8%	51,103	0.00%	838.42 req/s	210.07 ms	272.15 ms	本地舒适区内
150	60s	6%	44,889	0.00%	735.22 req/s	357.74 ms	469.28 ms	零错误但接近本机压力上沿

同轮 npm run smoke:launch-persona 已通过，覆盖普通学生 SVIP 后刷题、收藏、错题复习入口，租户管理员 dashboard/主题/学生/销售转化入口，平台管理员租户/套餐/审计入口，以及学生越权后台和跨租户访问拒绝。

同轮 npm run perf:postgres:evidence 运行成功，但本地默认 PostgreSQL 仍有生产前必须调优的 warning：jit=on、statement_timeout=0、idle_in_transaction_session_timeout=0、lock_timeout=0。上云后要按 docs/refactor/postgresql-4c16g-tuning.md 调整并重启需要重启的参数，再复跑证据采集和压测。

2026-07-01 API 契约门禁后读写复核

本轮在新增 node scripts/taro-api-contract-test.js 并纳入 npm run test:readiness 后复跑，确认前端接口契约守卫不会影响后端真实数据刷题读写容量。压测仍使用本地 Docker/Supabase 真实迁移库，排行榜未纳入默认负载。

并发 worker	时长	刷题写入比例	请求数	错误率	吞吐	P95	P99	结论
100	60s	8%	43,379	0.00%	710.38 req/s	257.59 ms	328.75 ms	通过 100 worker 舒适区门槛
150	60s	6%	43,738	0.00%	716.06 req/s	375.03 ms	485.60 ms	零错误但进入压力区

同轮 npm run perf:summary -- --allow-writes 已分别通过 100 worker P95 <= 300ms/P99 <= 800ms 和 150 worker P95 <= 500ms/P99 <= 1200ms 的容量观察阈值；150 worker 不建议作为当前本机 Docker 日常舒适区。

2026-07-01 Taro 角色旅程契约后读写复核

本轮在新增 node scripts/taro-persona-contract-test.js 并纳入 npm run test:readiness 后复跑，确认前端角色旅程契约守卫不会影响后端真实数据刷题读写容量。压测仍使用本地 Docker/Supabase 真实迁移库，排行榜未纳入默认负载。

并发 worker	时长	刷题写入比例	请求数	错误率	吞吐	P95	P99	结论
100	60s	8%	45,047	0.00%	737.22 req/s	244.12 ms	320.26 ms	通过 100 worker 舒适区门槛
150	60s	6%	41,707	0.00%	681.44 req/s	387.58 ms	510.79 ms	零错误但进入压力区

同轮 npm run perf:summary -- --allow-writes 已分别通过 100 worker P95 <= 300ms/P99 <= 800ms 和 150 worker P95 <= 500ms/P99 <= 1200ms 的容量观察阈值。

2026-07-01 02:48 真实数据容量复核

本轮按用户最新要求重新确认本地 Supabase 数据量、Docker Desktop 资源，并复跑只读上线门禁与 50/100/150 混合读写阶梯。排行榜仍未纳入默认负载，头像相关链路不参与压测，因为学生头像产品策略已固定为男女预设头像。

并发 worker	时长	刷题写入比例	请求数	错误率	吞吐	P95	P99	结论
30	120s	0%	64,382	0.00%	532.97 req/s	140.64 ms	193.69 ms	通过只读上线门禁
50	60s	10%	40,065	0.00%	658.11 req/s	151.63 ms	188.07 ms	混合读写舒适
100	60s	8%	37,290	0.00%	610.57 req/s	303.93 ms	376.47 ms	接近舒适区上沿
150	60s	6%	33,952	0.00%	555.08 req/s	490.53 ms	639.05 ms	零错误但进入压力区

本轮 npm run perf:summary 校验结果：

• 30 worker 只读门禁通过，满足 errors=0、errorRate<=0.001、p95<=300ms、p99<=800ms、duration>=120s。
• 50/100/150 worker 混合读写均为 0 错误；100 worker 已接近 P95=300ms 舒适线，150 worker 只作为压力上沿观察。

2026-07-01 03:12 真实数据容量复核

本轮在同一套本地 Docker/Supabase 真实迁移库上继续复跑，并先执行 npm run smoke:launch-persona 确认三类角色旅程通过。普通学生旅程覆盖 SVIP 后刷题、收藏和错题复习入口；租户管理员旅程覆盖 dashboard、主题、学生和销售转化入口；平台管理员旅程覆盖租户、套餐和审计入口；同时验证学生访问后台、租户管理员跨租户访问和学生访问平台后台均被拒绝。

并发 worker	时长	刷题写入比例	请求数	错误率	吞吐	P95	P99	结论
30	120s	0%	60,326	0.00%	499.27 req/s	151.29 ms	214.61 ms	通过只读上线门禁
50	60s	10%	35,608	0.00%	584.18 req/s	174.26 ms	224.04 ms	混合读写舒适
100	60s	8%	33,843	0.00%	554.42 req/s	326.21 ms	422.33 ms	接近舒适区上沿
150	60s	6%	32,364	0.00%	528.81 req/s	490.38 ms	662.42 ms	零错误但进入压力区

本轮 npm run perf:summary 校验结果：

• 30 worker 只读门禁通过，满足 errors=0、errorRate<=0.001、p95<=300ms、p99<=800ms、duration>=120s。
• 50/100/150 worker 混合读写均为 0 错误；100 worker 已接近舒适区上沿，150 worker 只作为压力观察，不作为生产承诺。

按 0.05 到 0.2 req/s/人的页面节奏粗略折算，50 worker 舒适吞吐约对应 2,920 到 11,680 名活跃在线学生请求吞吐，100 worker 上沿约对应 2,770 到 11,080 名，150 worker 压力区约对应 2,645 到 10,580 名。该数字仍是本地 Docker 观察值，正式承诺必须在目标 4 核 16G 云服务器和真实前端埋点下复跑。

2026-07-01 05:57 Docker API 受限资源复核

本轮在完成生产 provider readiness 加固、npm run smoke:launch-persona、npm run smoke:taro:h5:interaction 和 npm run perf:postgres:evidence 后复跑。压测入口为 npm run perf:api:docker-4c16g，API 容器按脚本默认限制为 2 CPU/4G，使用 PERF_AUTH_MODE=app_session，排行榜仍未纳入默认负载。

并发 worker	时长	刷题写入比例	请求数	错误率	吞吐	P95	P99	结论
30	120s	0%	42,089	0.00%	349.70 req/s	202.20 ms	295.16 ms	通过只读上线门禁
50	60s	10%	25,157	0.00%	416.54 req/s	215.00 ms	292.56 ms	混合读写舒适
100	60s	8%	23,873	0.00%	394.18 req/s	414.67 ms	495.91 ms	可用但延迟偏高
150	60s	6%	22,523	0.00%	370.53 req/s	621.55 ms	750.70 ms	零错误但进入压力区

本轮 npm run perf:summary 校验结果：

• 30 worker 只读门禁通过，满足 errors=0、errorRate<=0.001、p95<=300ms、p99<=800ms、duration>=120s。
• 50 worker 混合读写满足 P95<=500ms/P99<=1200ms，是当前受限 API 容器下更保守的舒适区。
• 100 worker 混合读写仍 0 错误，P95 约 415ms，适合作为上沿观察；150 worker P95 约 622ms，只作为压力区观察，不作为生产承诺。

按 0.05 到 0.2 req/s/人的页面节奏粗略折算，50 worker 舒适吞吐约对应 2,080 到 8,330 名活跃在线学生请求吞吐；100 worker 上沿约对应 1,970 到 7,880 名；150 worker 压力区约对应 1,850 到 7,410 名。生产 4 核 16G 首版容量建议先按这组本地受限资源折算值的 30% 到 50% 保守规划，即约 620 到 4,160 名活跃在线学生请求吞吐，再以上云复测和真实前端埋点修正。

2026-07-01 06:26 Docker API + DB 显式受限复核

本轮使用 BENCHMARK_LIMIT_DB_RESOURCES=true npm run perf:api:docker-4c16g，API 容器限制为 2 CPU/4G，Supabase PostgreSQL 容器限制为 2 CPU/8G，DB_POOL_MAX=10，压测鉴权继续使用 PERF_AUTH_MODE=app_session。这比 05:57 只限制 API 容器更接近本地 4C16G 资源压力，但 PostgreSQL 参数仍是本地默认值，并未按 docs/refactor/postgresql-4c16g-tuning.md 应用 shared-host profile。

场景	并发 worker	时长	刷题写入比例	请求数	错误率	吞吐	P95	P99	门禁结论
只读上线门禁	30	120s	0%	8,029	0.00%	66.50 req/s	1188.62 ms	1697.71 ms	失败，超过 P95/P99
混合读写	50	60s	10%	7,088	0.00%	115.82 req/s	905.13 ms	1211.98 ms	失败，超过 P95/P99
混合读写	100	60s	8%	6,383	0.00%	103.63 req/s	1720.26 ms	2101.02 ms	压力区
混合读写	150	60s	6%	5,640	0.00%	91.52 req/s	2688.31 ms	3284.99 ms	压力区

结论：资源更严格后系统仍保持 0 错误，但延迟不满足上线门禁。该结果不能作为生产容量承诺，反而证明云端正式部署前必须先完成 PostgreSQL shared-host 调参、pg_stat_statements、慢 SQL 观察和 4C16G 云服务器复测。尤其是 learning.trend、learning.stats、learning.practice_flow.create/detail/answer 在受限 DB 下最容易抬高 P95，应在云端结合慢 SQL 和 EXPLAIN (ANALYZE, BUFFERS) 继续看是否需要预聚合、缓存或索引微调。

按 50 worker 混合读写 115.82 req/s 粗略折算，理论请求吞吐约对应 580 到 2,316 名活跃在线学生，但因为该轮未完成 PostgreSQL 调参且只在本地 Docker Desktop 上运行，只能作为“未调参受限资源下限观察”，不能作为首版生产规划值。首版生产规划仍以上云调参后复测为准。

初步结论

• 本地高资源 Docker Desktop 历史结果显示代码和索引在 50/100 worker 下有较高吞吐；只限制 API 容器时，50 worker 混合读写 P95 约 215ms，100 worker P95 约 415ms，150 worker P95 约 622ms；进一步把 DB 容器也限制为 2 CPU/8G 后，30 worker 只读和 50 worker 混合读写均未通过延迟门禁。
• 最新 DB 显式受限结果说明：不能仅凭本地 Docker API 受限跑分给生产承诺，生产 4C16G 必须先应用 PostgreSQL shared-host 调参并启用 pg_stat_statements，再跑正式只读/混合读写矩阵。
• 生产如果使用 4 核 16G 单机，首版容量承诺不要再直接沿用 05:57 的 620 到 4,160 人估算；应先以云端调参后复测结果为准。没有云端复测前，可以把 05:57 结果看作“API 受限但 DB 未受限的乐观观察”，把 06:26 结果看作“DB 也受限但未调参的悲观观察”。
• 正式容量承诺必须在目标 4 核 16G 云服务器、生产 PostgreSQL 参数、对象存储/CDN、真实前端请求节奏和生产网络下复跑。

后续复测

上云后按 docs/refactor/performance-benchmark-runbook.md 复跑至少以下场景：

1. 只读 30/50/100 并发阶梯。
2. 混合读写 30/50/100 并发阶梯。
3. 结合 pg_stat_statements、慢 SQL、CPU、I/O、连接池和锁等待确认瓶颈。
4. 把代表性结果写入本地 docs/refactor/production-launch-evidence.json，再执行 npm run launch:gate。