适用版本： 7.9-7.9
1. 错误异常的基本描述 #
start object expected [index metadata identifiers] 是一个元数据解析异常，表示 Elasticsearch 在解析 index_metadata_identifiers 字段时，预期这里应该是一个 JSON object，但实际读到的不是对象结构。这个错误通常出现在读取快照仓库元数据、恢复快照或处理索引元数据清单时。
常见现象 #
- 仓库元数据读取失败，快照列举或恢复流程中断。
- 节点日志中出现
ElasticsearchParseException，并指向index_metadata_identifiers字段。 - 某个仓库或某份快照在升级、迁移或人工修改后开始无法正常读取。
典型报错与异常栈 #
org.elasticsearch.ElasticsearchParseException: start object expected [index_metadata_identifiers]
2. 为什么会发生这个错误 #
从源码看，Elasticsearch 在解析该字段时要求下一 token 必须是 START_OBJECT。如果仓库中的元数据文件被破坏、格式被改坏，或者跨版本迁移时写入了不兼容结构，就会直接抛出这个异常。常见原因包括：
- 仓库元数据文件被人工编辑或通过脚本错误修改。
- 对象存储或文件系统中的元数据文件损坏，导致 JSON/XContent 结构不完整。
- 非兼容版本生成的元数据被当前版本按不同结构解释。
- 仓库被多个集群或工具同时写入，导致元数据内容异常。
3. 如何排查和解决这个异常和解决这个异常 #
先确认是“哪个元数据文件里的这个字段坏了”。
- 查看完整异常栈，定位是读取仓库
RepositoryData、快照元数据还是索引元数据时触发。 - 如果问题发生在单个仓库，优先检查该仓库最近是否做过迁移、手工修复或跨版本接入。
- 对照最近正常的快照或元数据代际，判断是否是某次更新后引入的结构损坏。
- 如果可以安全访问底层存储，检查对应元数据文件中的
index_metadata_identifiers字段是否仍为对象结构。 - 如果问题来自版本兼容，确认产生该元数据的集群版本与当前读取版本的兼容性。
排查时需要注意的问题 #
- 这不是查询 DSL 解析错误，而是仓库/快照元数据内容错误。
- 不要在生产仓库上直接手工改元数据文件，错误修复不当会扩大损坏范围。
- 如果只有单个代际或单份快照触发问题，尽量缩小到具体损坏对象，而不是直接判定整个仓库不可用。
4. 如何解决这个错误 #
常用修复思路 #
- 如果是人工修改或迁移引起的格式错误，回滚到正确的元数据文件版本。
- 如果是单个损坏快照引起的问题，评估是否删除损坏快照并重建备份。
- 如果是版本兼容性导致，使用兼容路径完成迁移，避免用不受支持的版本直接读取旧元数据。
- 如果仓库整体元数据已不可信，先停止写入，完成一致性检查后再决定修复或重建仓库引用。
相关 Elasticsearch API #
GET /_snapshot/{repository}/_all：验证仓库是否还能列出快照。GET /_snapshot/{repository}/{snapshot}：确认问题是否集中在单个快照。POST /_snapshot/{repository}/_verify：验证仓库可用性。
借助 INFINI 产品提升排障效率 #
- INFINI Console 可帮助关联仓库异常、节点日志和最近变更时间线，快速定位损坏出现的时间点。
- INFINI Gateway 对此类离线元数据损坏帮助有限，但可以辅助确认是否有异常调用持续触发问题仓库。
5. 小结 #
start object expected [index metadata identifiers] 的核心是元数据结构不符合预期。处理时应从仓库或快照元数据文件入手，而不是从查询或网络层面排查。重点确认该字段是否损坏、是否被人工修改，以及是否存在版本兼容性问题。
附：日志上下文 #
} else if (INDEX_METADATA_IDENTIFIERS.equals(field)) {
if (parser.nextToken() != XContentParser.Token.START_OBJECT) {
throw new ElasticsearchParseException("start object expected [" + INDEX_METADATA_IDENTIFIERS + "]");
}
indexMetaIdentifiers.putAll(parser.mapStrings());
}
