设置TreeView子节点Checked属性触发System.NullReferenceException问题排查

我来帮你拆解这个异常的可能原因，以及对应的排查和修复思路：

1. 事件递归触发导致节点状态紊乱 #

你是在AfterCheck事件里修改子节点的Checked属性，但设置Checked会再次触发AfterCheck事件，这种递归调用会让节点状态陷入不稳定的中间状态，甚至导致节点引用被意外篡改，最终引发空引用异常——哪怕你断点看到childNode存在，递归过程中它的状态可能已经变了。

修复思路： #

修改节点属性前临时注销事件处理方法，操作完成后再重新注册，避免递归触发：

private void FluidFilterTree_AfterCheck(object sender, TreeViewEventArgs e)
{
    // 先注销事件，阻断递归
    FluidFilterTree.AfterCheck -= FluidFilterTree_AfterCheck;

    TreeNode ActiveNode = e.Node;
    if (ActiveNode.Parent == null) // 根节点，批量操作子节点
    {
        TreeNode childNode = ActiveNode.FirstNode;
        while (childNode != null)
        {
            childNode.Checked = false;
            childNode = childNode.NextNode;
        }
    }

    MessageBox.Show(e.Node.Text);

    // 重新注册事件
    FluidFilterTree.AfterCheck += FluidFilterTree_AfterCheck;
}

2. 循环边界的空引用漏洞 #

你原来用ActiveNode.GetNodeCount(false)作为循环次数，但每次循环后执行childNode = childNode.NextNode，当遍历到最后一个子节点时，childNode.NextNode会变成null，下一次循环访问childNode.Checked自然就触发空引用了——之前断点确认的是初始的childNode存在，但循环到最后一步时它已经变成null了。

修复思路： #

改用while循环直接判断childNode是否为null，逻辑更严谨：

// 替换原有的for循环
TreeNode childNode = ActiveNode.FirstNode;
while (childNode != null)
{
    childNode.Checked = false;
    childNode = childNode.NextNode;
}

或者用foreach遍历子节点集合，代码更简洁且不易出错：

foreach (TreeNode child in ActiveNode.Nodes)
{
    child.Checked = false;
}

3. 多线程或并发操作导致节点引用失效 #

如果有其他线程或者异步代码同时在修改TreeView的节点集合（比如添加、删除节点），会导致你拿到的childNode引用看似存在，实际已经被从控件中移除，访问属性时就会抛出异常。

排查思路： #

• 检查项目中是否有其他地方在操作该TreeView的节点，尤其是后台线程的操作；
• 所有UI控件的操作必须在UI线程执行，多线程场景下可以用Invoke/BeginInvoke包裹操作代码。

4. 节点内部状态损坏（极端情况） #

极少数情况下，TreeView节点可能因为初始化不完整、之前的异常操作导致内部状态损坏，此时访问Checked属性会直接抛出异常。

排查思路： #

• 检查TreeView的初始化代码，确保所有节点都被正确创建并添加，没有未初始化的空节点；
• 尝试在事件触发前手动遍历一遍子节点，逐个访问Checked属性，看是否能定位到具体的问题节点。

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