System.Text.Json不支持多维数组序列化的原因及解决方案咨询

一、System.Text.Json不支持多维数组的原因 #

System.Text.Json的核心设计目标是轻量、高性能，优先聚焦最常用的集合类型（如List<T>、一维数组）。多维数组（例如T[,]）属于相对小众的使用场景，微软在框架迭代中未默认内置其序列化逻辑，而是将扩展性开放给自定义转换器。而Newtonsoft.Json的定位是功能全面、兼容性优先，覆盖了更多边缘场景，原生实现了多维数组的序列化/反序列化逻辑，因此可以直接处理。

二、自定义JsonConverter处理大型二维数组的性能 #

性能完全取决于实现细节：

• 若直接使用Utf8JsonWriter/Utf8JsonReader这类System.Text.Json原生API实现转换器，性能会接近框架原生序列化水平，甚至优于Newtonsoft.Json——因为避免了Newtonsoft的反射开销与中间对象分配。
• 若实现中依赖反射、频繁转换为中间集合（比如把二维数组转成List<List<T>>再序列化），性能会显著下降，尤其是处理GB级大型数组时，内存分配会急剧飙升。
• 针对大型数组，建议采用流式处理，避免一次性加载整个数组到内存，可进一步优化性能与内存占用。

三、存入IDistributedCache的最优方案 #

方案1：自定义System.Text.Json转换器 + 压缩 #

实现针对二维数组的高效转换器（直接操作Utf8JsonWriter），序列化后用GZipStream或BrotliStream压缩，再存入缓存。压缩能大幅降低缓存占用空间，减少分布式缓存（如Redis）的网络传输开销。

方案2：直接序列化二进制（非JSON） #

对于纯数值型的大型二维数组（如int[,]、double[,]），可直接将数组转为二进制字节流：利用MemoryMarshal获取数组的内存指针，直接复制到字节数组后存入缓存。这种方式性能最优，序列化/反序列化几乎无开销，且数据体积最小。

注意事项 #

• 缓存键需包含数组的维度、类型等标识信息，避免反序列化时出现类型不匹配或维度错误。
• 根据数组的更新频率设置合理的缓存过期时间，或配置缓存淘汰策略。

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