Elasticsearch中Dictionary字典类型的索引机制及与List差异咨询

你在C#中使用的Dictionary<int, object>类型在写入Elasticsearch时，会被序列化为标准JSON嵌套对象结构，ES本身没有专属的字典类型，会默认按Object类型处理。

1. 字典类型的索引工作原理 #

• 序列化后的字典结构写入ES时，会被自动展开为扁平的分层字段路径，以你给出的示例文档为例，最终生成的可检索字段为：
  • name
  • paymentDict.card1.CardType
  • paymentDict.card1.CardName
  • paymentDict.card2.CardType
  • paymentDict.card2.CardName
• 若字典的键是动态生成的（比如后续不断新增card3、card4等新键），在默认动态映射规则下，ES会自动为新出现的键创建对应的字段映射，更新集群元数据。
• 高写入场景注意：如果字典的动态键数量极大，首先会触发ES默认的index.mapping.total_fields.limit（默认1000）字段数上限报错，其次每次新键产生带来的元数据更新操作会额外消耗集群资源，拖慢写入性能，严重时会引发元数据更新冲突。

2. 字典类型与List<object>的索引机制差异 #

二者索引机制完全不一致，核心差异如下：

• 字典结构的核心特征是会根据键的变化动态生成新的独立字段，每个键下的对象字段互相独立，不会出现跨对象的字段值混洗。
• 普通List<object>（默认映射为ES的Object数组）不会生成新字段，所有数组元素下的同名字段值会被合并为多值字段：还是以上面的卡片场景为例，如果你把结构改成List存储：

  {
    "name": "name1",
    "paymentList": [
      {"CardType": "Credit", "CardName": "Axis"},
      {"CardType": "Debit", "CardName": "Axis"}
    ]
  }
  

  最终生成的可检索字段为paymentList.CardType（值为["Credit", "Debit"]）、paymentList.CardName（值为["Axis", "Axis"]），同名字段的所有值会被合并，无法区分属于哪个数组元素，查询时会出现误匹配。
• 写入性能层面：如果你的字典动态键数量多，List<object>（尤其显式声明为Nested类型）的写入性能会远优于动态键的字典结构，不会出现字段数膨胀和元数据频繁更新的开销。

高写入场景下如果字典键不固定，建议将字典结构转换为List<object>（Nested类型）存储，把字典的键作为数组元素的一个普通字段（比如cardKey），可以避免字段膨胀问题，写入性能更稳定。

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