升级Highcharts .NET Core库至11.4.6后创建图表实例遇空对象错误

升级Highcharts .NET库从11.4.1到11.4.6后，创建柱状图时出现空对象引用错误，堆栈跟踪指向图表初始化代码的第37行。已确认categoryGuid、categoryTitle、optionCategoryResults、categoryResultsSeries等变量均正常，硬编码或移除部分内容后错误仍存在，旧版本代码可正常运行，官方更新日志未标注相关破坏性变更。

初始化代码如下：

var chart = new Highcharts
{
    ID = $"chart_{categoryGuid.ToString().Replace("-", "")}",
    Chart = new Chart
    {
        Height = "400",
        Type = ChartType.Column,
        Style = new Hashtable { { "FontFamily", "Segoe UI" } },
        BackgroundColor = "transparent",
    },
    Credits = new Credits { Enabled = false },
    Title = new Title { Text = categoryTitle },
    XAxis =
    [
        new XAxis
        {
            Categories = optionCategoryResults.Select(c => c.optionTitle).ToList(),
            Crosshair = new XAxisCrosshair()
        }
    ],
    YAxis =
    [
        new YAxis
        {
            Title = new YAxisTitle {Text = "Relative Score"},
        }
    ],
    Tooltip = new Tooltip
    {
        Shared = true,
        PointFormat = "<span style=\"color:{point.color}\">●</span> Score: <b>{point.y:.1f}</b><br/>"
    },
    PlotOptions =
    {
        Column = new PlotOptionsColumn
        {
            Stacking = PlotOptionsColumnStacking.Normal,
            Animation = new Animation
            {
                Duration = 2000,
                Easing = "easeOutBounce"
            }
        }
    },
    Legend =
    {
        Enabled = false
    },
    Series = categoryResultsSeries
};

排查解决思路 #

• 修正PlotOptions和Legend的初始化方式：旧版本可能允许直接用对象初始化器嵌套赋值（如PlotOptions = { Column = ... }），但11.4.6版本可能要求先显式实例化父对象，改成：

  PlotOptions = new PlotOptions
  {
      Column = new PlotOptionsColumn
      {
          Stacking = PlotOptionsColumnStacking.Normal,
          Animation = new Animation
          {
              Duration = 2000,
              Easing = "easeOutBounce"
          }
      }
  },
  Legend = new Legend { Enabled = false }
  

• 检查Animation.Easing的合法性：11.4.6版本可能对缓动函数的取值做了限制，尝试移除Easing属性，或替换为官方文档明确支持的枚举值（如果有对应枚举类型）
• 拆分初始化步骤调试：把图表初始化拆成逐行赋值，每赋值一个属性后添加调试断点，观察是否触发空引用，定位具体出错的属性赋值环节
• 检查categoryResultsSeries的内部元素：确认每个Series对象的必填属性（如Name、Data）都已正确初始化，11.4.6版本可能新增了必填项
• 反编译对比版本差异：获取11.4.1和11.4.6版本的库文件，反编译后查看Highcharts、PlotOptions、Legend等类的构造函数和内部逻辑，确认是否有未公开的破坏性变更

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