OpenSearch中match_phrase_prefix查询特定资产编号异常问题

问题背景 #

使用OpenSearch 7.10.2版本（Lucene 9.4.2），对配置了以下规则的asset_number字段执行match_phrase_prefix查询时出现异常：

索引配置 #

{
  "settings": {
    "analysis": {
      "normalizer": {
        "lowercase_normalizer": {
          "type": "custom",
          "filter": ["lowercase"]
        }
      }
    }
  },
  "mappings": {
    "_routing": {
      "required": true
    },
    "properties": {
      "asset_number": {
        "type": "text",
        "fields": {
          "keyword": {
            "type": "keyword",
            "normalizer": "lowercase_normalizer"
          }
        }
      }
    }
  }
}

异常表现 #

索引中存在对应资产编号，但部分前缀（如PC1234、PD1234）的match_phrase_prefix查询无结果；查询pc1、pd1时能正常返回结果，且PB1234、PE1234等前缀查询正常。本地/预发布环境使用相同数据与查询语句可正常运行。

测试查询语句 #

{
  "query": {
    "bool": {
      "must": [
        {
          "match_phrase_prefix": {
            "asset_number": "pc"
          }
        }
      ]
    }
  }
}

核心原因分析 #

1. 路由键不匹配
   索引设置了_routing: required，数据写入时指定了路由键，查询时如果未携带正确的路由参数，OpenSearch只会查询路由哈希匹配的分片，而非全部分片。若PC/PD开头的资产集中在未被查询到的分片，就会出现无结果的情况。本地/预发布环境分片数量少或数据分布刚好命中查询分片，所以表现正常。

2. 查询缓存异常
   生产环境的查询缓存可能缓存了旧的分片结果，短前缀（如pc）的查询命中了过期缓存，而更长的前缀（如pc1）绕过了缓存，因此能返回正确结果。本地/预发布环境缓存更新更频繁，未出现此问题。

3. 分片状态异常
   生产环境中部分分片可能存在未刷新、未分配或故障情况，导致对应分片的数据无法被查询到。本地/预发布环境集群状态更稳定，无此类异常。

验证与解决步骤 #

• 验证路由问题：在查询时添加路由参数，例如：

  POST /your_index/_search?routing=your_routing_key
  

  若能返回结果，则确认是路由参数缺失导致。
• 检查分词结果：调用_analyze接口确认分词逻辑：

  POST /your_index/_analyze
  {
    "field": "asset_number",
    "text": "PC1234"
  }
  

  确保输出为["pc1234"]，排除分词异常。
• 刷新索引：执行索引刷新操作，确保数据同步到所有分片：

  POST /your_index/_refresh
  

• 检查分片状态：查看分片健康状态，排查异常分片：

  GET /_cat/shards/your_index?v
  

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