4. 文档嵌套结构：嵌套文档模型、父子文档关系、嵌套查询与聚合

在倒排索引与文档存储的融合架构中，文档嵌套结构是处理复杂业务实体的核心手段。领域驱动设计中的聚合根、值对象、实体关系，在索引层需要精确映射为嵌套文档模型、父子文档关系或扁平化字段。本章从领域建模视角出发，系统阐述三种嵌套模式的适用场景、索引结构、查询能力与聚合约束。

4.1 嵌套文档模型（Nested Document Model）

嵌套文档模型将子对象作为独立的内嵌文档存储在父文档的数组字段中。每个嵌套文档在 Lucene 层面被索引为独立的隐藏文档（hidden document），从而保持子对象字段间的查询独立性。

4.1.1 核心特征

4.1.2 领域建模示例：订单与商品行项

// 订单聚合根（嵌套文档映射）
{
  "orderId": "ORD-2024-001",
  "customer": {
    "name": "张三",
    "level": "VIP"
  },
  "items": [
    {
      "productId": "P001",
      "productName": "机械键盘",
      "quantity": 2,
      "unitPrice": 399.00,
      "category": "外设"
    },
    {
      "productId": "P002",
      "productName": "无线鼠标",
      "quantity": 1,
      "unitPrice": 199.00,
      "category": "外设"
    }
  ],
  "totalAmount": 997.00
}

4.1.3 嵌套查询与聚合

嵌套查询使用 nested 查询类型，确保查询条件作用于同一个嵌套对象内部。

// 查询包含"机械键盘"且单价大于300元的订单
// 正确：使用 nested 查询，条件作用于同一嵌套对象
{
  "query": {
    "nested": {
      "path": "items",
      "query": {
        "bool": {
          "must": [
            { "match": { "items.productName": "机械键盘" } },
            { "range": { "items.unitPrice": { "gt": 300 } } }
          ]
        }
      }
    }
  }
}

// 错误：不使用 nested 查询会导致跨对象交叉匹配
// 可能匹配到"机械键盘"和"鼠标单价>300"的订单

嵌套聚合使用 nested 聚合路径，再配合子聚合分析嵌套对象内的统计信息。

// 统计每个商品类别的平均单价和总销量
{
  "size": 0,
  "aggs": {
    "items_nested": {
      "nested": { "path": "items" },
      "aggs": {
        "by_category": {
          "terms": { "field": "items.category" },
          "aggs": {
            "avg_price": { "avg": { "field": "items.unitPrice" } },
            "total_qty": { "sum": { "field": "items.quantity" } }
          }
        }
      }
    }
  }
}

4.2 父子文档关系（Parent-Child Relationship）

父子文档关系通过 join 字段在同一个索引中建立文档间的层级关联。父文档和子文档是独立的 Lucene 文档，拥有各自的 _id 和版本号，支持独立更新。

4.2.1 核心特征对比

4.2.2 领域建模示例：博客文章与评论

// 索引映射定义 join 字段
{
  "mappings": {
    "properties": {
      "join_field": {
        "type": "join",
        "relations": {
          "article": "comment"   // 父类型: 子类型
        }
      },
      "title": { "type": "text" },
      "content": { "type": "text" },
      "author": { "type": "keyword" }
    }
  }
}

// 父文档（文章）
{
  "_id": "article-001",
  "title": "领域驱动设计实践",
  "content": "本文探讨DDD在微服务中的应用...",
  "join_field": { "name": "article" }
}

// 子文档（评论）
{
  "_id": "comment-001",
  "join_field": {
    "name": "comment",
    "parent": "article-001"   // 指定父文档ID
  },
  "commenter": "李四",
  "text": "非常实用的文章！",
  "rating": 5
}

4.2.3 父子查询与聚合

父子查询支持从父查子和从子查父两种方向。

// 查询：查找被评分大于4的评论的文章
{
  "query": {
    "has_child": {
      "type": "comment",
      "query": {
        "range": { "rating": { "gte": 4 } }
      },
      "score_mode": "max"   // 取子文档最高分
    }
  }
}

// 查询：查找某篇文章下所有包含"精彩"的评论
{
  "query": {
    "has_parent": {
      "parent_type": "article",
      "query": {
        "term": { "_id": "article-001" }
      }
    },
    "bool": {
      "must": { "match": { "text": "精彩" } }
    }
  }
}

父子聚合需要先通过 children 聚合进入子文档空间。

// 聚合：统计每篇文章的平均评分
{
  "size": 0,
  "aggs": {
    "articles": {
      "terms": { "field": "_id", "size": 10 },
      "aggs": {
        "comments": {
          "children": { "type": "comment" },
          "aggs": {
            "avg_rating": { "avg": { "field": "rating" } }
          }
        }
      }
    }
  }
}

4.3 嵌套结构选型决策矩阵

在领域建模阶段，根据以下决策矩阵选择最合适的嵌套结构：

4.4 嵌套结构在倒排索引中的物理存储

理解嵌套结构在 Lucene 层面的物理存储方式，有助于做出正确的领域建模决策。

4.5 嵌套查询与聚合的领域驱动设计模式

在领域驱动设计中，嵌套查询和聚合应遵循以下模式：

1. 聚合内查询： 使用嵌套文档模型，查询条件限定在同一个聚合根内部。例如“查找包含过期商品行项的订单”。
2. 跨聚合查询： 使用父子文档模型或应用层关联。例如“查找被高评分用户评论的文章”。
3. 聚合统计： 嵌套聚合用于值对象集合的统计分析；父子聚合用于实体集合的统计分析。
4. 版本一致性： 嵌套文档保证聚合根内部的一致性；父子文档允许子实体独立版本演进。

4.6 嵌套结构的性能优化策略