如何使用ElasticSearch Term查询过滤对象数组中的指定role值？

你的数据结构中，role字段位于configuration.roles这个对象数组下，之前的查询主要问题是字段路径不完整，另外可能忽略了字段的映射类型，导致匹配失败。

原始数据结构 #

_source: {
  configuration: {
    roles : [
        {role : "lead"},
        {role : "editor"},
      ]
  }
}

错误查询的问题点 #

• 第一个查询直接用role作为字段名，完全没匹配到正确的嵌套路径
• 第二个查询用roles.role，缺少了上层的configuration前缀
• 第三个查询的字段和值写法完全错误

正确的查询方式 #

情况1：字段为keyword类型（精确匹配）

如果configuration.roles.role的映射类型是keyword，可以用term查询：

body: {
  size: 10,
  query: {
    bool: {
      must: { 
        term: {
          "configuration.roles.role" : "editor"
        }
      }
    }
  }
}

情况2：字段为text类型（全文匹配）

如果该字段是text类型，term查询可能无法匹配（因为text会分词，term是精确匹配），此时改用match查询：

body: {
  size: 10,
  query: {
    bool: {
      must: { 
        match: {
          "configuration.roles.role" : "editor"
        }
      }
    }
  }
}

额外提示：使用nested查询（如果数组需要独立匹配）

如果你的roles字段被映射为nested类型（而非默认的object类型），则必须用nested查询确保数组中的每个对象独立匹配：

body: {
  size: 10,
  query: {
    nested: {
      path: "configuration.roles",
      query: {
        term: {
          "configuration.roles.role": "editor"
        }
      }
    }
  }
}

验证步骤 #

1. 通过GET /your_index/_mapping查看configuration.roles.role的字段映射，确认是text还是keyword，或者是否存在keyword子字段（例如configuration.roles.role.keyword）
2. 如果有keyword子字段，优先用该子字段做term查询，避免分词影响匹配结果

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