私有化版并发说明

本文说明 VeryReport 私有化部署版的并发授权规则：并发如何计算、超过上限时系统如何提示、管理员与普通用户应如何处理，以及如何通过商务渠道增购并发数。

适用说明：SaaS 云端版按订阅席位数计费，不设「同时在线人数」上限，无需阅读本文。私有化版按模块 + 并发档位一次性授权，并发是核心授权维度之一。部署形态对比见 SaaS 与私有化对比。

一、什么是并发？

私有化 License 中的并发数（concurrency），表示同一时刻允许同时在线使用业务内容的浏览器会话数量上限。

• 并发 ≠ 账号数：您可以创建任意多个用户账号，但同一时刻最多只有 License 授权数量的会话在「占槽」使用系统。
• 示例：购买 10 并发，可注册 200 个账号；若第 11 人在同一时刻打开报表/看板，将触发并发超限提示。
• 不限并发：License 中并发为 -1 或未限制时，系统不做并发拦截。

二、并发计算原理

2.1 什么情况下占用 1 个并发？

VeryReport 采用「浏览业务内容才占并发」策略（与行业常见报表/BI 产品一致）：

2.2 系统如何统计活跃会话？

1. 用户进入 BI 主界面后，前端每 5 分钟向服务端发送一次心跳（touch），刷新该会话的最后活跃时间。
2. 服务端维护当前活跃会话列表；若某会话 30 分钟无心跳，视为已离线并自动释放并发槽（如强关浏览器未正常退出）。
3. 用户关闭 Tab 或退出登录时，前端会主动调用 release 释放槽位。
4. 并发上限读取当前激活 License 中的 concurrency 字段；可在「授权管理 → 授权状态」查看已购并发数。

2.3 计数公式（理解用）

在任意时刻，有效并发占用数 = 当前未过期（30 分钟内有过心跳）的独立 sessionId 数量。当该数量 ≥ License 并发上限 时，新的会话无法再占槽（管理员见下文例外）。

三、并发超过上限时会怎样？

当新用户（或新 Tab）尝试占槽，而当前活跃会话已达授权上限时：

• 服务端返回业务错误码 40310（CONCURRENCY_LIMIT_EXCEEDED）。
• 页面弹出「访问人数已满」阻断提示，文案为：「当前并发访问已达授权上限，请等待其他用户退出后重试。」
• 系统不排队：必须等他人释放槽位后才能进入。
• 提示页提供「立即重试」按钮；同时每 60 秒自动重试一次占槽。

该机制仅作用于私有化部署；SaaS 模式不会触发并发拦截。

四、遇到「访问人数已满」如何处理？

4.1 普通业务用户

• 点击提示中的立即重试，或等待倒计时结束自动重试。
• 联系已占线的同事关闭不再使用的 Tab，或退出登录释放并发。
• 若长期满额，向 IT 管理员或采购同事反馈，评估增购并发。

4.2 系统管理员

超级管理员进入产品内 授权管理（路径：系统管理 → 授权管理）：

• 在授权状态页查看 License 中的并发上限与客户信息。
• 切换到并发会话页，查看当前在线会话列表（用户名、IP、最近活跃时间、访问路径）。
• 对长时间占用或异常会话，可踢出指定会话，立即释放 1 个并发槽。
• 管理员自身在并发已满时尝试进入，系统会自动踢出最旧会话后放行（便于运维介入）。

4.3 常见释放场景

五、如何增加并发？

私有化并发属于商务授权项，需通过 VeryReport 销售/客户成功渠道办理，无法在 SaaS 控制台自助下单。

5.1 增购流程

1. 联系销售：说明当前并发档位、期望目标（如 10 → 20）及使用场景。可通过 联系我们 或您的专属客户成功经理提交需求。
2. 签订补充协议 / 补差价：按合同约定支付并发升级费用。官网定价页对私有化采用「按并发规模面议」模式，具体金额以商务报价为准（参见 官网定价 FAQ）。
3. 获取新 License：VeryReport 签发包含更高 concurrency 的新授权文件（.lic）。
4. 重新激活：管理员在「授权管理 → 激活 License」上传新文件或粘贴授权文本，激活成功后立即生效，无需重新部署应用。

5.2 常见档位与升级说明

5.3 容量规划建议

• 按业务高峰同时在线人数估算，而非注册账号总数。
• 报表集中报送、经营分析早会、大屏轮播等场景易形成并发尖峰，建议预留 20%～30% 余量。
• 多实例集群部署时，并发计数依赖 Redis 共享存储；若 Redis 不可用会降级为单机计数（集群环境下可能不够精确，建议保障 Redis 高可用）。

六、相关文档

中创微（上海）软件有限公司 · VeryReport