Solr 8嵌套文档索引异常：查询结果呈扁平化而非嵌套

1. 检查Schema是否配置了嵌套核心字段 #

Solr 实现嵌套文档依赖两个核心字段，缺失任意一个都会导致文档被扁平化：

• _root_：用于关联父子文档，所有子文档的该字段值会自动继承父文档的id（或手动指定为父文档ID），必须配置为string类型且同时开启索引和存储：

<field name="_root_" type="string" indexed="true" stored="true"/>

• _nest_path_（Solr 7.0+推荐）：用于维护文档的嵌套层级路径，同样需要配置为string类型并开启索引存储：

<field name="_nest_path_" type="string" indexed="true" stored="true"/>

如果使用Managed Schema而非手动schema.xml，可通过Solr Admin的Schema页面确认字段是否存在，或用API手动添加。

2. 验证提交的JSON数据格式是否正确 #

Solr仅识别_childDocuments_关键字段包裹的子文档，拼写和格式错误会导致子文档被当作独立顶层文档：

• 错误示例（子文档与父文档平级）：

[
  {"id": "parent1", "title": "父文档"},
  {"id": "child1", "content": "子文档"}
]

• 正确示例（子文档放在_childDocuments_数组内）：

{
  "id": "parent1",
  "title": "父文档标题",
  "_childDocuments_": [
    {
      "id": "child1",
      "content": "子文档内容1"
    },
    {
      "id": "child2",
      "content": "子文档内容2"
    }
  ]
}

注意：子文档的_root_会自动设置为父文档ID，无需手动指定；若手动设置必须与父文档ID完全一致。

3. 确认查询方式是否适配嵌套结构 #

普通q=*:*查询会返回所有文档（包括父子），视觉上看似扁平化，但实际上父子文档的_root_字段是关联的。要验证嵌套结构，需使用Solr嵌套查询语法：

• 查询指定父文档的所有子文档：

curl "http://localhost:8983/solr/your_core/select?q={!parent which='id:parent1'}*:*"

• 查询父文档及其所有子文档：

curl "http://localhost:8983/solr/your_core/select?q=*:*&fq=_root_:parent1"

• 通过子文档反向查询父文档：

curl "http://localhost:8983/solr/your_core/select?q={!child of='id:parent1'}content:子文档内容"

4. 排查是否存在其他配置干扰 #

• 检查solrconfig.xml中是否启用了会扁平化文档的处理器，比如UpdateRequestProcessorChain中是否有错误配置；
• 确保提交数据时没有使用overwrite=true等可能影响嵌套结构的参数；
• 若使用批量提交，确认整个JSON结构是单个父文档包含_childDocuments_，而非多个平级文档数组。

内容的提问来源于stack exchange，提问作者Mark Sholund