协同性能测试报告

本报告评估 Univer 协同引擎在多人实时协作场景下的性能表现,并给出测试环境、指标定义与结果。

测试覆盖单文档多人编辑和多文档同时编辑两种场景。文档预热后,测试记录持续编辑期间的提交确认延迟、吞吐量、提交达成率,以及协同服务进程的 CPU 和内存占用。

测试环境

协同服务与数据库分别部署在独立的服务器上。结果表中的机器规格指图中的协同节点。

100%

PostgreSQL 保存文档记录、变更集、快照记录和数据块引用,OSS 保存快照中的单元格数据块。

本报告的测试结果均来自单个协同节点。当同时编辑的文档数超过单节点容量时,可以增加协同节点,分担不同文档的编辑负载。各节点共用数据库,并通过发布订阅同步房间、在线状态和编辑广播。具体配置见部署指引中的「多协同节点」。

项目配置
Univer 协同 SDK 版本1.5.2
操作系统与运行时Ubuntu 26.04.1 LTS,Node.js 24.14.0
存储配置PostgreSQL 18.6 + 阿里云 OSS
数据库适配器PostgreSQL + S3 Adapter
协同节点规格阿里云 ECS ecs.g9i.xlarge(4 vCPU、16 GiB)和 ecs.g9i.2xlarge(8 vCPU、32 GiB),Intel Xeon 6982P-C,40 GiB ESSD
数据库服务器规格阿里云 ECS ecs.c9i.large,2 vCPU、4 GiB,Intel Xeon 6982P-C,60 GiB ESSD
模拟客户端阿里云 ECS ecs.u2a-c1m2.xlarge,4 vCPU、8 GiB,AMD EPYC
网络连接阿里云深圳地域。客户端、协同节点和数据库经同地域私网通信,OSS 使用内网端点

协同服务配置

4 核和 8 核节点均将 runtime.maxLoadedUnits 从默认值 1,200 调至 4,000,允许单节点在内存中同时保留最多 4,000 份文档。其余 SDK 运行时参数沿用默认值,工作线程数由 SDK 自动确定。快照也采用默认策略:距上次成功快照累计 50 个版本,或单次变更集达到 5 MiB 时触发。

以下是压测服务的核心代码节选。适配器使用已初始化的 PostgreSQL 连接池和 OSS 客户端,传输层挂载到 Node.js HTTP 服务。

TypeScript
const dbAdapter = await PostgresS3DatabaseAdapter.create({  pool,  s3: { client, bucket, prefix },});const service = new UniverCollabService({  dbAdapter,  runtime: { maxLoadedUnits: 4000 },});const endpoint = new UniverCollabEndpoint(service);const transport = createNodeTransport();transport.register(endpoint);transport.attach(server);

测试快照

测试快照用于初始化每份文档。下表的单元格数指预热前已经填入数据或公式的单元格数量。

快照名称单元格数内容
blank0空白工作表
10k-cells约 10,000数字、文本和公式
100k-cells约 100,000数字、文本和公式

两份预置数据的表格均有 26 列,其中 14 列为数字、9 列为文本、3 列为引用同行数据的公式。

测试方法

模拟客户端

结果表中的“编辑人数”按独立会话计数。每个会话加入一份文档,通过 HTTP 提交单元格修改,并通过 WebSocket 接收服务端确认。测试脚本直接调用协同接口。HTTP 请求和 WebSocket 确认等待均采用 10 秒超时。

预热与正式采样

每轮先从指定快照创建文档,待所有会话加入后开始预热。首次编辑会触发服务端加载文档。单文档场景预先提交 1 次编辑。多文档场景按文档顺序分别提交 1 至 49 次,第 50 份文档起从 1 次重新计数。这样各文档从不同版本开始正式编辑,保存快照的时刻也随之错开。

所有文档完成预热后开始正式采样。首次提交延迟在预热阶段单独记录。结果表中的提交统计、延迟分位数、CPU 和内存均取自正式采样阶段。

编辑负载

单文档场景使用 blank,逐步增加编辑人数。多文档场景分别使用上述三种快照,在每种快照下逐步增加活跃文档数。两种场景中,每次提交都只包含一条 sheet.mutation.set-range-values,向一个单元格写入一个数值。

测试条件单文档多人编辑多文档同时编辑
每份文档编辑人数按测试组调整,见结果表固定为 2 人,适用于全部多文档测试
每次编辑的操作错峰修改各自的单元格错峰修改各自的单元格
每人编辑频率每 6 秒 1 次每 2 秒 1 次
每轮采样时长300 秒300 秒

指标定义

指标定义
提交确认延迟从客户端发出一次编辑,到该客户端收到服务端确认所经过的时间。P50、P95、P99 分别表示 50%、95%、99% 的成功提交在相应时间内收到确认。Max 表示成功提交中最长的确认延迟。
吞吐量采样期间成功提交的次数除以采样时长,单位为次/秒。
提交达成率成功提交数占计划提交数的百分比。计划提交数包含成功、失败及未发出的提交。
CPU 均值 / 峰值(%)协同服务进程在采样期间的平均 CPU 占用和最高采样值。每个 CPU 核心满载计为 100%,多核合计可超过 100%。
内存峰值(MiB)采样期间协同服务进程常驻内存(RSS)的最大采样值。

并发规模的判定标准

每轮达标要求为提交确认延迟 P99 < 1,000 ms、提交达成率 > 90%,且协同进程持续运行至所有测试文档通过一致性核对。提交延迟和达成率按四舍五入前的数值判定。

每个档位按本报告列出的实测轮次判定。仅测一轮时取该轮结果。有多轮时,每轮均须达标。采样中断或指标缺失时,相应数据记为“缺失”,并注明原因。

测试结果的适用范围

为评估服务端处理并发编辑的能力,测试使用 Node.js 脚本模拟编辑会话,直接调用协同接口提交单元格修改。提交确认延迟仅衡量脚本从发出请求到收到服务端确认所用的时间,不包含用户在浏览器中操作和等待表格渲染的时间。

本报告的数据仅供性能评估和单协同节点容量规划参考。实际性能取决于部署配置、网络条件、文档大小以及编辑操作的类型和频率。

“最高达标”指在本次测试条件下,满足判定标准的最大已测档位。部分达标档位的平均 CPU 占用已接近节点上限。最高达标档位仅供容量规划参考,不宜直接作为生产环境的长期运行负载。 实际部署时,应为并发高峰和资源占用波动预留安全余量,并在目标环境中用典型业务负载验证可长期稳定承载的规模。

测试结果

汇总

下表按服务器规格和文档大小汇总单协同节点的最高达标规模。单文档场景以同时编辑同一份文档的人数计,多文档场景以同时活跃的文档数计。每行列出对应档位的吞吐量、提交确认延迟,以及 CPU 和内存占用。各档位的提交达成率和更高负载下的测试情况见详细数据。

单文档多人编辑

两种规格的 500 人档各完成一轮测试,均达标。

快照服务器规格最高达标编辑人数吞吐量(次/秒)P95(ms)P99(ms)CPU 均值 / 峰值(%)内存峰值(MiB)
blank4 核 16 GiB50083.313.317.427.8 / 54.8777
blank8 核 32 GiB50083.313.918.025.6 / 100.51,322

多文档同时编辑

快照服务器规格最高达标活跃文档数吞吐量(次/秒)P95(ms)P99(ms)CPU 均值 / 峰值(%)内存峰值(MiB)
blank4 核 16 GiB2,1002,100.029.9194.6118.9 / 332.65,829
blank8 核 32 GiB2,9002,900.017.856.2145.3 / 363.97,404
10k-cells4 核 16 GiB1,8001,800.0106.2311.9241.3 / 379.36,304
10k-cells8 核 32 GiB2,4002,400.026.9482.0286.3 / 749.38,071
100k-cells4 核 16 GiB380380.091.1200.9389.6 / 401.812,440
100k-cells8 核 32 GiB750750.033.572.3649.7 / 782.129,276

4 核 8 GiB 与 8 核 16 GiB 的负载参考

4 核 8 GiB 和 8 核 16 GiB 的参考负载分别根据 4 核 16 GiB 和 8 核 32 GiB 的实测数据估算(非目标规格实测值)。两种目标规格分别按 6.5 GiB 和 13.7 GiB 的协同进程内存预算,从详细数据中选取同一场景和快照下 RSS 峰值符合预算的最大达标档位。多轮测试取各轮最高 RSS。

单文档多人编辑
快照目标服务器规格参考编辑人数内存峰值(MiB)
blank4 核 8 GiB500777
blank8 核 16 GiB5001,322
多文档同时编辑
快照目标服务器规格参考活跃文档数内存峰值(MiB)
blank4 核 8 GiB2,1005,829
blank8 核 16 GiB2,9007,404
10k-cells4 核 8 GiB1,8006,304
10k-cells8 核 16 GiB2,4008,071
100k-cells4 核 8 GiB3505,413
100k-cells8 核 16 GiB6008,943

节点池选型建议

采用多节点部署时,网关可按文档大小将编辑请求分别路由到中小型文档池和大型文档池。以下为各池的单节点选型参考,测试负载为每份文档 2 人、每人每 2 秒编辑一次。

  • 中小型文档池建议优先评估 4 核 8 GiB。 在 4 核 16 GiB 的实测结果中,符合 8 GiB 规格内存预算的最高达标档位为空白表格 2,100 份、每份约 10,000 个单元格的表格 1,800 份。
  • 大型文档池建议评估 8 核 16 GiB 或 8 核 32 GiB。 以每份约 100,000 个单元格为例,8 核 32 GiB 实测的最高达标档位为 750 份,其中符合 16 GiB 规格内存预算的最高达标档位为 600 份。

详细数据

单轮列出实测值。同一档位的多轮结果合并展示时,吞吐量、P50、P95、P99、Max、提交达成率和 CPU 均值分别取各轮的算术平均值,CPU 和内存峰值取各轮最高值。备注注明轮数和各轮 Max 的范围,必要时补充 P99 范围。各轮单独判定是否达标。

单文档多人编辑

快照:blank
4 核 16 GiB
编辑人数吞吐量(次/秒)P50(ms)P95(ms)P99(ms)Max(ms)提交达成率CPU 均值 / 峰值(%)内存峰值(MiB)备注
15025.02.94.35.412.6100.00%5.7 / 27.9690—
40066.75.210.112.429.8100.00%19.8 / 41.9781—
50083.36.613.317.440.1100.00%27.8 / 54.8777—
8 核 32 GiB
编辑人数吞吐量(次/秒)P50(ms)P95(ms)P99(ms)Max(ms)提交达成率CPU 均值 / 峰值(%)内存峰值(MiB)备注
15025.03.44.45.510.7100.00%5.1 / 66.51,123—
40066.76.210.813.428.2100.00%18.2 / 75.91,196—
50083.37.513.918.036.9100.00%25.6 / 100.51,322—

多文档同时编辑

快照:blank
4 核 16 GiB
活跃文档数吞吐量(次/秒)P50(ms)P95(ms)P99(ms)Max(ms)提交达成率CPU 均值 / 峰值(%)内存峰值(MiB)备注
500500.01.11.63.725.0100.00%33.8 / 89.32,057—
1,0001,000.01.12.410.757.0100.00%61.4 / 193.13,133—
1,5001,500.01.34.840.1361.6100.00%86.3 / 279.04,134—
2,1002,100.01.729.9194.61,156.2100.00%118.9 / 332.65,829共 3 轮,P99 范围 141.9–254.0 ms,Max 范围 508.2–1,543.0 ms
2,2002,200.01.870.1270.41,227.5100.00%123.5 / 369.96,050第 1 轮
2,2002,199.82.0274.0860.42,787.299.99%127.1 / 392.66,172第 2 轮
2,2002,198.82.2376.51,062.43,747.899.95%126.1 / 347.26,071第 3 轮,延迟未达标
2,3002,298.13.2878.61,675.84,313.999.92%135.8 / 370.86,336提交 P99 未达标
2,4002,204.82,192.52,457.52,888.64,611.591.87%163.6 / 394.87,023提交 P99 未达标
8 核 32 GiB
活跃文档数吞吐量(次/秒)P50(ms)P95(ms)P99(ms)Max(ms)提交达成率CPU 均值 / 峰值(%)内存峰值(MiB)备注
500500.01.01.32.226.1100.00%30.6 / 78.12,823—
1,0001,000.01.11.73.958.9100.00%53.8 / 163.43,961—
1,5001,500.01.22.69.651.8100.00%76.3 / 165.14,694—
2,2002,200.01.46.515.0189.2100.00%112.2 / 428.16,030—
2,6002,600.01.813.038.8334.1100.00%132.2 / 477.56,891—
2,7002,700.01.811.735.0270.5100.00%135.1 / 661.77,026共 3 轮,CPU 峰值为 518.6%–661.7%,Max 范围 234.9–313.9 ms
2,8002,800.02.014.652.1352.0100.00%140.5 / 537.47,331共 3 轮,CPU 峰值为 464.9%–537.4%,Max 范围 273.3–430.0 ms
2,9002,900.02.217.856.2395.2100.00%145.3 / 363.97,404共 1 轮
3,0002,375.52,537.12,715.42,868.13,821.879.18%194.3 / 570.98,257共 2 轮,提交 P99 和达成率均未达标,Max 范围 3,311.4–4,332.2 ms
快照:10k-cells
4 核 16 GiB
活跃文档数吞吐量(次/秒)P50(ms)P95(ms)P99(ms)Max(ms)提交达成率CPU 均值 / 峰值(%)内存峰值(MiB)备注
500500.01.13.27.7206.5100.00%71.1 / 165.82,514—
1,0001,000.01.35.116.4115.6100.00%133.6 / 330.53,879—
1,6001,600.02.042.7256.71,165.7100.00%215.2 / 371.15,677—
1,8001,800.02.7106.2311.91,197.3100.00%241.3 / 379.36,304共 3 轮,Max 范围 773.7–1,455.4 ms
1,9001,899.95.4330.2797.13,210.599.99%257.9 / 399.36,626第 1 轮
1,9001,891.44.6552.61,541.56,200.099.54%256.7 / 397.26,686第 2 轮,延迟未达标
2,0001,868.42,084.52,401.92,964.07,658.393.42%284.8 / 397.67,104提交 P99 未达标
2,1001,904.02,202.32,631.73,022.04,550.790.67%291.2 / 393.07,580提交 P99 未达标
8 核 32 GiB
活跃文档数吞吐量(次/秒)P50(ms)P95(ms)P99(ms)Max(ms)提交达成率CPU 均值 / 峰值(%)内存峰值(MiB)备注
500500.01.02.04.127.3100.00%69.3 / 139.93,408—
1,0001,000.01.12.86.830.3100.00%127.2 / 238.84,601—
2,0002,000.01.58.221.2184.4100.00%249.9 / 634.87,222—
2,2002,200.01.711.633.8244.0100.00%268.6 / 713.07,716—
2,3002,300.01.914.4197.21,043.4100.00%284.4 / 696.98,071共 3 轮,P99 范围 39.6–368.8 ms,Max 范围 326.1–1,700.6 ms
2,4002,400.02.126.9482.02,287.6100.00%286.3 / 749.38,071共 1 轮
2,5002,499.83.3600.41,228.13,346.499.99%302.5 / 744.78,308提交 P99 未达标
2,6002,367.61,053.52,489.82,646.24,510.691.06%324.3 / 741.48,865提交 P99 未达标
2,7002,222.72,467.72,583.52,687.63,627.482.32%334.4 / 776.59,238共 2 轮,提交 P99 和达成率均未达标,Max 范围 3,547.4–3,707.3 ms
快照:100k-cells
4 核 16 GiB
活跃文档数吞吐量(次/秒)P50(ms)P95(ms)P99(ms)Max(ms)提交达成率CPU 均值 / 峰值(%)内存峰值(MiB)备注
100100.01.46.622.868.0100.00%91.6 / 202.22,662—
250250.01.923.056.8637.3100.00%246.3 / 396.64,046—
350350.05.176.2170.5479.8100.00%365.5 / 397.95,413—
380380.05.791.1200.9725.9100.00%389.6 / 401.812,440共 3 轮,Max 范围 615.2–856.9 ms
390390.05.8106.0275.31,339.3100.00%391.1 / 399.613,639采样后内存耗尽
400394.76.2108.1210.3675.898.67%377.4 / 398.314,226内存耗尽,1,385 次提交失败
8 核 32 GiB
活跃文档数吞吐量(次/秒)P50(ms)P95(ms)P99(ms)Max(ms)提交达成率CPU 均值 / 峰值(%)内存峰值(MiB)备注
100100.01.32.821.736.7100.00%91.8 / 200.13,392—
250250.01.25.823.0284.2100.00%242.0 / 471.15,013—
500500.01.516.233.9121.6100.00%482.6 / 716.47,721—
600600.02.026.765.6302.1100.00%575.9 / 772.18,943—
700700.02.429.964.5288.1100.00%641.4 / 782.525,692—
750750.02.633.572.3280.7100.00%649.7 / 782.129,276共 3 轮,Max 范围 266.2–295.1 ms
775725.22.732.771.0314.293.57%607.2 / 789.129,360内存耗尽,4,474 次提交失败

我们将持续优化协同服务,降低 CPU 和内存开销,提升大型文档的协同编辑性能。

你觉得这篇文档如何?

© 2026 DreamNum Co., Ltd.