GraphQL中含通配符的全名搜索及空格匹配问题咨询

我正在用GraphQL API实现患者搜索功能，支持按名、姓或全名搜索。目前用ILIKE运算符构建搜索条件，但搜索含空格的全名（如“Mary John”）时得不到预期结果。

我用的搜索条件示例：

{
  _text: {
    field: "patient.firstName",
    op: "ILIKE",
    value: "doe%john"
  }
}

这个条件本想匹配名中包含“Doe”后接“John”的患者，但没返回预期结果。不确定所用GraphQL API是否支持预期的ILIKE通配符用法，也不清楚其他实现方式。

问题 #

1. GraphQL API通常是否支持在字符串字段中使用带%通配符的ILIKE运算符进行模式匹配？
2. 若支持，搜索含空格的全名（如“Mary John”）的正确语法是什么？
3. 在GraphQL中实现可处理空格和部分匹配的全名搜索，有哪些最佳实践或替代方案？

回答 #

1. GraphQL API是否支持带%通配符的ILIKE？

GraphQL本身没有强制要求支持ILIKE或%通配符，这完全取决于后端API的实现逻辑。如果你的GraphQL服务基于SQL数据库（比如PostgreSQL）构建（例如用Hasura、Prisma、Apollo Server + SQL等），绝大多数都会支持ILIKE和%通配符——因为这直接映射到SQL的原生语法。但如果后端是非SQL存储或自定义逻辑，可能不支持，需要查看对应API的文档确认。

2. 搜索含空格全名的正确语法

你当前的核心问题是字段选择错误：你只针对patient.firstName做匹配，但“Mary John”这类全名是名+姓的组合，应该结合firstName和lastName，或者如果有单独的fullName字段，直接用该字段。

• 如果有fullName字段：

  {
    _text: {
      field: "patient.fullName",
      op: "ILIKE",
      value: "%Mary John%"
    }
  }
  

  这里的%表示任意字符（包括空格），前后加%可以匹配包含“Mary John”的任意字符串。

• 如果只有firstName和lastName字段：
  需要用多条件组合，比如匹配“Mary”是名、“John”是姓：

  {
    _and: [
      { _text: { field: "patient.firstName", op: "ILIKE", value: "%Mary%" } },
      { _text: { field: "patient.lastName", op: "ILIKE", value: "%John%" } }
    ]
  }
  

  如果要支持任意顺序的匹配（比如“John Mary”也能命中），改用_or组合：

  {
    _or: [
      { _and: [
          { _text: { field: "patient.firstName", op: "ILIKE", value: "%Mary%" } },
          { _text: { field: "patient.lastName", op: "ILIKE", value: "%John%" } }
        ]
      },
      { _and: [
          { _text: { field: "patient.firstName", op: "ILIKE", value: "%John%" } },
          { _text: { field: "patient.lastName", op: "ILIKE", value: "%Mary%" } }
        ]
      }
    ]
  }
  

3. 全名搜索的最佳实践与替代方案

• 拆分搜索词组合匹配：把用户输入的带空格的搜索词拆分成单个关键词，分别匹配firstName和lastName，比如输入“Mary John”拆成“Mary”和“John”，要求两个词都出现在名或姓中：

  {
    _and: [
      { _or: [
          { _text: { field: "patient.firstName", op: "ILIKE", value: "%Mary%" } },
          { _text: { field: "patient.lastName", op: "ILIKE", value: "%Mary%" } }
        ]
      },
      { _or: [
          { _text: { field: "patient.firstName", op: "ILIKE", value: "%John%" } },
          { _text: { field: "patient.lastName", op: "ILIKE", value: "%John%" } }
        ]
      }
    ]
  }
  

• 使用全文搜索：如果后端是SQL数据库（如PostgreSQL），可以创建全文索引，GraphQL服务通常会提供对应的全文搜索操作符（比如Hasura的_fts），比ILIKE更高效，还能处理分词、同义词等场景。
• 整合专业搜索服务：如果搜索需求复杂（比如模糊匹配、排序、多字段权重），可以把数据同步到Elasticsearch或Algolia，然后通过GraphQL网关提供统一的搜索接口。
• 限制通配符位置：如果不需要全模糊匹配，尽量用前缀/后缀匹配（比如"Mary%"或"%John"），比前后都加%的性能更好，尤其是数据量较大时。

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