标题:【数据统计错误】数据管理表列脚「已填写」统计虚高,与实际数据行数不一致(distinctCount 接口对经流程改写的记录重复计数)
────────────────────────────────
一、问题概述
在低代码应用的数据管理表视图中,为数值列启用列脚统计(表脚聚合方式选「已填写」)后,表脚显示的「已填写 N」大于该表实际数据行数。
定位结果:问题不在业务数据,而在平台后端聚合接口 POST /form-data/distinctCount 对「经流程自动改写过」的记录存在重复计数,导致同一最终值被统计多次。数据本身完全正确,无需修数。
────────────────────────────────
二、影响范围
· 影响功能:数据管理表视图的列脚统计(已填写 / 未填写)
· 影响接口:POST /form-data/distinctCount
· 触发条件:① 目标列的值由流程(跨表节点 edit-data / add-data)自动写入;② 该记录在流程改动快照表中缺少 after_snapshot 记录
· 严重程度:中(显示类问题,不影响数据正确性与业务计算,但会导致对账、盘点等场景误判)
· 是否影响数据:否。底层行数、行内容、流程计算结果均正确
────────────────────────────────
三、复现环境(两套独立部署实例均可稳定复现,偏差完全一致)
实例 A
· 版本:v2.1.1(2026-10-22 发布)
· 部署:Linux 服务器版(banban-client-2.1.1-linux-x64-server.zip)
· 系统:Ubuntu 22.04.5 LTS x86_64
· 二进制:/opt/banban-server/banban,md5 e4eb3dc59924a98b44e628d18bc25a18
· 地址:
实例 B
· 版本:v2.1.1
· 部署:Mac 桌面版
· 系统:macOS 12.7.6 Monterey x86_64
· 二进制:/Applications/斑斑AI低代码.app,app.asar md5 02050c26446b5955da8ec12034667d04
· 地址:
────────────────────────────────
四、复现步骤
1. 进入低代码应用「ERP应用」(应用 ID:dm85wd0g3ziq)
2. 打开数据表「库存台账-自动」(表 UID:t_a8crjpl5jjwe)
3. 进入「数据管理表」视图
4. 点击表头设置 → 开启列脚统计 → 对「累计出库数量」列选择「已填写」
5. 观察表脚显示值
实际结果:表脚「已填写」显示 35,但该表实际只有 32 行数据
预期结果:应显示 32
────────────────────────────────
五、实际结果 vs 预期结果
实例 find 实际行数 表脚「已填写」 偏差
Srv-156 32 35 +3
Mac-40 11 14 +3
且只有「累计出库数量」这一列虚高,同表其它列全部正确:
列 find 实际 distinctCount 是否一致
累计入库数量 32 32 一致
累计出库数量 32 35 虚高 3
关联产品/设备档案 32 32 一致
经办人 32 32 一致
关联仓库档案 31 31 一致
注:「累计入库数量」由「采购入库单」流程写入,「累计出库数量」由「销售出库单」流程写入。两者字段定义完全一致(同为 numberInput 类型、decimalPlaces:2、defaultValue:0),唯一差别是出库列经过的流程改写路径不同。
────────────────────────────────
六、偏差分布规律(关键线索)
虚高不是随机,而是固定落在 3 个特定值上,每个值恰好多 1 次:
值 find 实际行数 distinctCount 偏差
0 17 17 0
1 4 5 +1
3 4 4 0
4 1 2 +1
5 1 1 0
6 1 1 0
8 1 1 0
10 3 4 +1
13/21/31/32/80/150 1/1/1/1/1/3 同左 0
被重复计数的,正是那些「累计入库数量 = 累计出库数量」(入库与出库同时被流程改写过)的记录。Srv-156 实例中值=1/4/10 的候选行:
数据ID 入库 出库 物料编码 重复计数
4nm0ozsl2esh 1 1 WL2026102700019 是
1w7dlvv4oqv91j5jtm68ri3i0dzfry6r:2 10 10 WL2026102700021 是
1w7dlvv4oqv91j5jtm68ri3i0dzfry6r:1 10 10 WL2026102700020 是
9pwxs6ox1nty30ytlpw6bpi1t9inaqwk:0 10 10 WL2026101500005 是
3qiwcwmbrei9yt5b2n8hl4pzgh3bxpco:0 1 1 WL2026101500003 是
23fh3f8rest8i5g5jnpobwih1l2t7z66:0 1 1 WL2026101500008 是
qg4al6ueamnu5o5grwpdqba6ayk6acra:1 4 4 WL2026101500010 是
w948idlmb9nbwex2jhm2h5npbtfisuux:0 1 1 WL2026101500014 是
推断的根因:
表 flow_immediate_mutations 中可查到流程对库存台账的 191 条跨表改动记录(source = cross_table_node,action = add/edit),每条都保存了 target_uuid + before_snapshot + after_snapshot。
逐一比对发现:被重复计数的 3 条记录,恰好是在该表中缺少 after_snapshot 的记录(其余被流程改写的行均有快照)。推测聚合逻辑在遍历流程改动记录时,对「流程改写过但快照缺失」的记录多计入了一次同一最终值。
供开发定位的相关数据库表:
· flow_immediate_mutations —— 流程跨表改动快照表,字段含 target_uuid、after_snapshot、changed_field_uids、action
· flow_execution_records —— 流程执行记录,含 flow_id、table_id、uuid、process_version
────────────────────────────────
七、已排除的可能原因(均不成立)
· 数据库真的多了 3 条脏数据
→ find 返回 total=32、rows=32,与 LevelDB 物理行数一致;distinct 返回的去重值列表正常
· 存在 _data_stage = deleted/adding 的隐藏行被计入
→ distinctCount 传 stage=normal/adding/deleted/all 各值,统计结果恒为 35,不随 stage 变化
· 筛选条件(filters)导致差异
→ 分别传 {}、{logic:AND,conditions:[]}、排除 0 的条件,结果恒为 35
· 分页导致漏算/多算
→ pageSize=1..10、pageNumber=1..4 各种组合,total 恒为 32
· 关联数据 JOIN 导致行放大
→ 同表关联列 distinctCount 求和均 = 32/31,无虚高
· 流程公式配置错误导致数据被改坏
→ 逐行核算「累计出库数量 × 成本单价 = 累计出库金额」全部成立(32×107275=3432800、21×24800=520800、31×23500=728500、80×303=24240 …),量纲正确
· 与 v2.1.1 升级有关
→ 两实例升级前后行为一致,升级未触碰业务数据
────────────────────────────────
八、当前规避方案
· 将该列列脚统计方式由「已填写」改为「求和」「平均」「最大」「最小」(走另一条计算路径,实测数值正确)
· 或不以列脚统计为准,直接以数据管理表的行数 / 分页 total 作为计数依据
────────────────────────────────
九、接口调用样例(便于开发复现)
POST /auth/login
Content-Type: application/json
{"username": "admin", "password": "******"}
→ 201,取响应头 Set-Cookie: community_bb_sid=...
POST /form-data/find
Cookie: community_bb_sid=...
Content-Type: application/json
{
"nocodeId": "dm85wd0g3ziq",
"tableUID": "t_a8crjpl5jjwe",
"pagination": {"pageNumber": 1, "pageSize": 200},
"select": {"fields": ["f_31g6pblmb5x4", "f_7mrwqtced4e7",
"f_c8maxjagwojr", "f_ii4phkij9dqz"]}
}
→ 201,pagination.total = 32
POST /form-data/distinctCount
Cookie: community_bb_sid=...
Content-Type: application/json
{
"nocodeId": "dm85wd0g3ziq",
"tableUID": "t_a8crjpl5jjwe",
"columnId": "f_ii4phkij9dqz",
"options": {"stage": "normal", "filters": {}}
}
→ 201
[
{"value": 0, "count": 17},
{"value": 1, "count": 5}, ← 实际应为 4
{"value": 4, "count": 2}, ← 实际应为 1
{"value": 10, "count": 4}, ← 实际应为 3
... 其余分组 count 正确
]
各分组 count 求和 = 35,实际应为 32
关键字段对照:
· t_a8crjpl5jjwe 库存台账-自动(表)
· f_c8maxjagwojr 累计入库数量(数值正确)
· f_ii4phkij9dqz 累计出库数量(统计虚高的列)
· f_31g6pblmb5x4 数据ID(记录唯一标识,含 :index 后缀)
· f_7mrwqtced4e7 物料编码
────────────────────────────────
十、期望修复
1. distinctCount 的分组计数应与 find 的实际行数一致,同一列不得出现 count 求和 > 行数
2. 排查流程改动记录与聚合统计的关联逻辑,对「流程改写过但 after_snapshot 缺失」的记录补齐或去重处理
3. 建议补充回归用例:数值列经流程多次改写后,distinctCount 的 count 求和应恒等于该列在 find 结果中的非空行数
────────────────────────────────
更多数字孪生可视化干货内容等你发现
了解更多内容