Dictionary扩展方法Split偶发System.ArgumentNullException异常原因分析

我来帮你拆解这个偶发异常的问题，首先咱们先聚焦异常本身：System.ArgumentNullException 出现在迭代器的 MoveNext 方法中，说明异常是在延迟执行批次生成时触发的（因为你用了 yield return，Split 方法返回的是懒加载的枚举器，只有调用 ToList() 时才会真正生成每个批次）。结合你说的50%概率触发，大概率是以下几种情况：

1. 自定义键类型（TKey）的 Equals/GetHashCode 方法未正确处理 null #

这是最可能的原因。如果你的 TKey 是自定义引用类型，且它的 Equals 方法在传入 null 参数时直接抛出 ArgumentNullException（比如没有做 null 检查就强制类型转换），那么当某个批次恰好包含 null 键的元素时，ToDictionary 就会触发这个异常。

由于 Dictionary 的枚举顺序是无序的，null 键可能随机出现在不同批次中——有的批次包含它就抛异常，有的不包含就正常运行，刚好符合你说的50%概率。

举个错误的实现例子：

public class MyCustomKey
{
    public int Id { get; set; }

    // 错误：未处理null参数
    public override bool Equals(object obj)
    {
        var other = (MyCustomKey)obj; // obj为null时会抛出异常
        return Id == other.Id;
    }
}

修复方案：修改自定义键的 Equals 方法，正确处理 null：

public override bool Equals(object obj)
{
    if (obj is null) return false;
    if (ReferenceEquals(this, obj)) return true;
    if (obj.GetType() != GetType()) return false;
    
    var other = (MyCustomKey)obj;
    return Id == other.Id;
}

2. 多线程环境下原字典被并发修改 #

你提到调用 Split 时字典非空，但因为 Split 是懒加载的，ToList() 才会真正遍历生成批次。如果在这个过程中，其他线程修改了原字典：

• 比如添加了带 null 键的元素，且键类型的比较器不兼容 null，就会触发和上面一样的异常；
• 虽然通常并发修改会抛出 InvalidOperationException（提示集合已修改），但极端情况下可能因枚举器状态异常间接导致 ArgumentNullException。

修复方案：在生成批次前先创建原字典的快照，避免并发修改的影响：

// 先复制一份快照，再处理批次
var dictSnapshot = new Dictionary<TKey, TValue>(ItemsDictionary.APIitems);
var batches = dictSnapshot.Split(20).ToList();

3. 原字典存在 null 值类型键（罕见） #

如果 TKey 是值类型（比如 int），正常情况下 Dictionary 不允许存储 null 键，但如果通过反射或其他非常规手段插入了 null 键，那么 ToDictionary 时会因值类型无法接受 null 而抛出异常。不过这种情况非常少见，因为编译器会直接阻止此类操作。

修复方案：检查字典初始化代码，改用可空值类型（如 int?）如果需要存储 null 键，同时确保没有非常规插入操作。

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