Corteza项目中多值字段在图表统计中的计数问题分析与修复

在Corteza低代码平台2023.9.7版本中，用户报告了一个关于多值字段在图表统计中的功能异常。该问题表现为：当记录包含多个值时，图表仅统计第一个值而忽略后续值，导致数据可视化结果不准确。经确认这是一个回归问题，因为在2022.3.1版本中该功能表现正常。

问题现象

在CRM模块的行业分类统计场景中：

• 某条记录包含"energy"和"electronics"两个行业标签
• 理想情况下，这两个标签都应被分别计数
• 但实际图表中仅"energy"被计数，"electronics"被完全忽略

技术背景

多值字段(Multi-Value Fields)是数据存储中的常见设计，允许单个字段存储多个取值。在统计图表场景中，通常需要对这类字段进行"展开式计数"——即每个独立值都应参与聚合计算。

问题根源

通过代码比对发现，2023.9.x版本在图表数据处理层面对多值字段的处理逻辑存在缺陷：

1. 数据预处理阶段未正确展开多值数组
2. 聚合计算时仅读取字段值的第一个元素
3. 缺少对值类型的完整性校验

解决方案

开发团队在2023.9.x-fix-chart-mv-keys分支中实现了修复方案：

1. 重构数据预处理流程，增加多值字段展开逻辑
2. 修改聚合算法，确保遍历所有值元素
3. 添加类型安全检测机制
4. 覆盖测试所有官方支持的数据库类型

影响范围

该修复涉及：

• 所有基于多值字段的图表统计
• 包括柱状图、饼图等常见图表类型
• 不影响单值字段的现有逻辑

最佳实践建议

对于使用多值字段的场景，建议：

1. 明确字段基数：区分单值和多值场景
2. 版本升级时进行数据一致性校验
3. 复杂统计场景考虑预先展开多值字段
4. 定期验证图表数据与实际记录的对应关系

该修复已通过完整测试并合并到稳定分支，用户升级到包含该修复的版本即可恢复正常功能。