ZstdNet库异常求助：‘Src size is incorrect’报错排查

云原生阿岚

2026-6-30

ZstdNet字典压缩抛出“Src size is incorrect”异常的排查与解决

问题背景

使用ZstdNet库结合预生成字典压缩短文本时，多数场景正常，但特定情况下会抛出“Src size is incorrect”异常，复现代码如下：

var text =  "bla bla, bla bla bla";
var bytes = Encoding.UTF8.GetBytes(text);
var dic = ZstdNet.DictBuilder.TrainFromBuffer(text.Split(' ').Select(Encoding.UTF8.GetBytes) );

排查思路

检查字典训练的输入样本合法性：text.Split(' ')会在文本首尾有空格、连续空格时生成空字符串，对应的Encoding.UTF8.GetBytes("")是长度为0的字节数组，这类空样本会导致Zstd训练出的字典存在异常，后续压缩时触发校验错误。
验证字典与压缩数据的兼容性：训练字典用的是拆分后的单词样本，压缩的是完整文本字节流，若样本格式不符合Zstd字典训练的预期（比如空样本、异常短样本），会导致字典无法正确匹配压缩数据，触发大小校验失败。
排查ZstdNet版本问题：旧版本的ZstdNet可能存在短文本/空样本处理的bug，建议确认是否使用最新稳定版。
检查压缩逻辑的完整性：若压缩代码中存在源数据截断、长度计算错误（如MemoryStream未正确Flush或获取长度），也会触发该异常。

解决建议

过滤无效训练样本：拆分文本时移除空条目，避免空字节数组进入字典训练：

var dic = ZstdNet.DictBuilder.TrainFromBuffer(
    text.Split(' ', StringSplitOptions.RemoveEmptyEntries)
        .Select(Encoding.UTF8.GetBytes)
);

校验训练样本长度：额外过滤过短的样本（如长度小于2的字节数组），确保训练输入符合Zstd要求：

var dic = ZstdNet.DictBuilder.TrainFromBuffer(
    text.Split(' ', StringSplitOptions.RemoveEmptyEntries)
        .Select(Encoding.UTF8.GetBytes)
        .Where(b => b.Length >= 2)
);