如何编写适配芝加哥艺术学院API的高精准容错Elasticsearch JSON查询

针对你遇到的「姓名拼写错误+目标姓名含中间名」的问题，推荐两种高精准度的Elasticsearch查询方案，既能修正轻微拼写错误，又能兼容中间名的存在：

方案一：短语匹配+模糊容错+间隔允许（推荐） #

这个方案结合了短语匹配的词序一致性、模糊容错的拼写修正，以及slop参数允许中间插入词（比如中间名），同时通过前缀长度限制避免误匹配：

criteria = {
  "query": {
    "match": {
      "artist_title": {
        "query": "Romare Beardon",
        "type": "phrase",
        "slop": 2,
        "fuzziness": "AUTO",
        "prefix_length": 2,
        "max_expansions": 10
      }
    }
  }
}

参数说明： #

• type: phrase：强制保持查询词的词序，避免出现「Bearden Romare」这类逆序匹配
• slop: 2：允许查询词之间最多2个位置的间隔，足以容纳中间名（比如Romare [Howard] Bearden仅间隔1个词）
• fuzziness: AUTO：根据词的长度自动设置编辑距离，对「Beardon」（6个字母）会允许1次编辑操作，刚好修正为「Bearden」
• prefix_length: 2：要求每个词的前2个字符必须精确匹配，这样「Beardon」的前缀「Be」不会和「Pearson」的「Pe」混淆，解决之前单独用fuzzy的误匹配问题
• max_expansions: 10：限制模糊匹配扩展的候选词数量，避免生成过多无关结果，兼顾性能和精准度

方案二：拆分名姓的布尔模糊匹配 #

如果需要更灵活的匹配逻辑，可以将名和姓拆分开，分别做模糊匹配，同时强制两者都命中：

criteria = {
  "query": {
    "bool": {
      "must": [
        {
          "fuzzy": {
            "artist_title": {
              "value": "Romare",
              "fuzziness": 1,
              "prefix_length": 2
            }
          }
        },
        {
          "fuzzy": {
            "artist_title": {
              "value": "Beardon",
              "fuzziness": 1,
              "prefix_length": 2
            }
          }
        }
      ]
    }
  }
}

优势： #

• 强制同时匹配名和姓的模糊结果，避免单一词匹配带来的无关结果
• 拆分后各自的模糊匹配更精准，适合姓名拆分明确的场景

为什么之前的尝试有局限？ #

• 原始match_phrase：无拼写容错，无法处理「Beardon」→「Bearden」的错误
• match_phrase+slop：解决了中间名问题，但未支持拼写修正
• 单独fuzzy：未限制词的位置和组合逻辑，导致误匹配「Pearson」这类无关姓氏

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