Highcharts堆叠waterfall图出现未传入的未知数值求助

问题场景 #

• 实际触发场景：项目中使用Highcharts的堆叠waterfall图组件时，传入特定组合的series数据后，标注为"Dec 20"的柱体顶部会渲染开发侧未主动传入的可疑数值，该数值完全不在传入的原始数据范围内
• 问题可稳定复现，对应的基础初始化代码片段如下：

Highcharts.chart('container', {
  chart: {
    type: 'waterfall',
  // 其余业务配置省略
})

核心排查思路 #

• 优先核查waterfall类型的内置计算逻辑：Highcharts原生waterfall图默认按数据传入顺序自动执行值累加，堆叠场景下如果未显式标记每个数据点的类型，引擎很容易将普通数据点误判为中间合计节点，自动计算并渲染预期外的合计值
• 逐点校验Dec 20分类下的所有关联数据配置：检查是否存在关联该分类的堆叠数据项，被误设置了isSum、isIntermediateSum类型的标识，或是未显式约束数据标签的取值来源
• 排查全局配置的冲突规则：确认是否在全局配置中开启了waterfall的自动汇总能力，导致非预期的计算值被默认渲染在柱顶位置

可落地解决方案 #

• 对所有普通非合计类的数据点，显式添加配置属性isIntermediateSum: false、isSum: false，从数据定义层面避免引擎的类型误判
• 针对Dec 20分类对应的数据项，显式约束数据标签的取值规则，强制展示数据点自身传入的原始值，不使用引擎自动计算的累加结果，参考配置片段：

dataLabels: {
  format: '{point.y}',
  allowOverlap: false
}

• 如果项目不需要使用waterfall图的自动合计能力，可在图表初始化配置中全局关闭自动汇总逻辑，添加配置项waterfall: { autoPoint: false }，从根源上阻止引擎生成非预期的计算数值

内容的提问来源于stack exchange，提问作者Zaffer