Elasticsearch 8.x中script_fields与runtime_mapping的核心差异及选型指南

你已经知道script_fields定义的字段无法用于排序，除此之外，二者在作用范围、支持场景、复用性等方面还有关键区别，具体如下：

• 作用生命周期与范围

  • script_fields是请求级临时字段：仅在当前查询请求中生效，查询结束后不会被保留，也不会写入索引，完全是一次性的计算结果。
  • runtime mappings支持索引级持久化或请求级临时定义：既可以在创建索引时作为映射的一部分持久化，也可以在单个查询中临时添加；持久化的runtime字段可以被所有针对该索引的后续查询复用。

• 支持的操作场景

  • script_fields仅能用于返回查询结果：无法参与过滤查询、聚合分析，除了不能排序外，也不能在bool查询的filter/must子句中作为条件使用。
  • runtime mappings的适用场景更全面：不仅可以返回结果，还支持用于过滤查询、各类聚合（如terms、avg聚合）、排序，甚至可以作为字段参与索引的其他操作逻辑。

• 字段类型与校验

  • script_fields无需指定字段类型：脚本返回的原始值直接作为结果返回，ES不会做类型校验，若脚本返回值类型不一致，可能导致结果异常。
  • runtime mappings必须明确指定字段类型（如keyword、long、date）：ES会对脚本输出的值做类型校验，确保符合定义的类型，避免类型错误。

• 执行时机与性能表现

  • script_fields在**查询取回阶段（fetch phase）**执行：只有当文档被筛选出来后才会计算字段值，若返回文档量较大，会增加取回阶段的性能开销。
  • runtime mappings可在**查询阶段（query phase）**执行：如果用于过滤或聚合，会提前计算字段值并参与筛选，减少后续需要处理的文档数量；即使仅用于返回结果，由于有明确的类型定义，执行效率更稳定。

• 复用性

  • script_fields无复用性：每次需要计算该字段时，都必须在查询中重新编写完整的脚本逻辑。
  • runtime mappings支持复用：持久化的runtime字段可被所有查询直接调用；即使是请求级的runtime字段，也能在同一个查询的多个子查询、聚合中复用脚本逻辑。

官方文档中，「Runtime fields」和「Script fields」章节对二者的定位与使用有详细说明，核心差异围绕字段的生命周期、适用场景展开。

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