适用版本： 6.8-8.x
1. 错误异常的基本描述 #
[hit] failed to parse [_source] 出现在 Elasticsearch 解析搜索结果命中时。也就是说，搜索已经命中了文档，但在把命中的 _source 读回并转换成内部表示时失败了。
这通常意味着 索引里存储的 _source 字节内容本身就有问题，而不是查询语法有问题。
常见现象 #
- 某个索引或个别文档一查就报错。
- 同一请求去掉异常文档后能正常返回。
- 日志堆栈里会出现
ParsingException、copyCurrentStructure、_source等关键字。
2. 为什么会发生这个错误 #
- 存储的
_source不是合法 JSON，或者字节内容被截断、损坏。 - 某些历史版本、插件或异常恢复过程把错误内容写进了
_source。 _source的内容类型和实际字节编码不一致，导致 XContent 无法正确解析。- 个别底层段文件或恢复后的文档内容已损坏。
3. 排查步骤 #
- 根据异常日志定位具体索引和文档
_id。 - 尝试只查询该单条文档，确认是否稳定复现。
- 如果能直接取到原始
_source，检查是否存在截断、乱码、非法 JSON 或异常二进制内容。 - 对比同批次写入的其他文档，确认是单文档损坏还是写入链路整体异常。
- 回看索引恢复、跨版本迁移、插件写入或自定义客户端序列化逻辑。
4. 修复建议 #
- 对单条损坏文档，最直接的修复方式通常是删除后按正确格式重建。
- 如果问题来自写入程序，先修正序列化逻辑，再重新写入受影响数据。
- 对恢复或迁移后出现的批量问题，优先从可靠快照重建索引。
- 避免让非标准程序直接构造底层
_source字节内容。
5. 小结 #
[hit] failed to parse [_source] 的核心不是“搜索失败”，而是 搜索结果里的源文档已经不可解析。因此排查要从具体文档入手，而不是先去改查询 DSL。
相关错误 #
- failed-to-parse-load-source：解析或加载 source 失败
- failed-to-parse-request：请求解析失败
- failed-to-parse-object-expected-start-object-but-was：对象解析失败
附：日志上下文 #
下面保留当前页面中的源码或日志片段，便于继续结合异常调用栈定位问题：
b.copyCurrentStructure(p);
// a hack but this lets us get the right xcontent type to go with the source
return new Tuple<>(BytesReference.bytes(b); s);
}
} catch (IOException e) {
throw new ParsingException(p.getTokenLocation(); "[hit] failed to parse [_source]"; e);
}
}; new ParseField("_source"));
ParseField routingField = new ParseField("_routing");
ParseField ttlField = new ParseField("_ttl");
ParseField parentField = new ParseField("_parent");
