MySQL MATCH AGAINST 怎样控制布尔全文检索的前缀匹配

在站内搜索里，用户常常只输入一个词的开头，例如 deploy，希望同时命中 deployment、deployer 等词。MySQL 的 MATCH ... AGAINST 可以完成这件事，但写法不是把 * 当成 LIKE 的任意字符串通配符，而是要放在布尔全文检索词的末尾。

官方地址：https://dev.mysql.com/doc/refman/8.4/en/full-text-search.html

可执行的核心写法是 MATCH(title, content) AGAINST('+deploy*' IN BOOLEAN MODE)：+ 表示这个条件必须满足，末尾的 * 表示按 deploy 前缀匹配。先保证查询列与 FULLTEXT 索引列一致，再排查分词、停用词和查询表达式，通常就能定位“明明有数据却搜不到”的原因。

先让 MATCH 覆盖同一组列

前缀匹配的第一道门不是查询字符串，而是索引。下面的示例把标题和正文放进同一个 FULLTEXT 索引，后续 MATCH 也必须按相同列顺序引用它们。列名不一致、列集合不同，都会让排查变得混乱。

-- 创建演示表，让标题和正文共享一个全文检索字段集合
CREATE TABLE search_docs (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    title VARCHAR(200) NOT NULL,
    content TEXT NOT NULL,
    FULLTEXT KEY ft_title_content (title, content)
) ENGINE = InnoDB;

-- 准备同一前缀下的不同单词，便于观察前缀命中范围
INSERT INTO search_docs (title, content) VALUES
    ('Deploy checklist', 'deployment needs a rollback plan'),
    ('Release notes', 'the deployer records each release'),
    ('Debug guide', 'debugging does not start with deploy');

这里的 FULLTEXT KEY ft_title_content (title, content) 是数据结构约束：查询中写 MATCH(title, content) 才能保持列集合一致。若只索引 content，却在查询里把 title 也放进 MATCH，应先调整索引或查询，不要先改成普通字符串拼接。

用布尔模式表达必选词和前缀

真正控制前缀的是布尔模式中的末尾星号。查询词 +deploy* 可以拆成两个语义：+ 要求记录必须包含这个条件，* 指示 MySQL 使用 deploy 作为词的前缀。它不是正则表达式，也不是把任意字符都吞掉的通配符。

-- 用布尔模式按 deploy 前缀检索标题或正文
SELECT
    id,
    title,
    MATCH(title, content) AGAINST('+deploy*' IN BOOLEAN MODE) AS score
FROM search_docs
WHERE MATCH(title, content) AGAINST('+deploy*' IN BOOLEAN MODE)
ORDER BY score DESC, id ASC;

上面的条件可以命中包含 deploy、deployment 或 deployer 的记录；是否命中还取决于全文解析器是否把它们识别为可检索词。ORDER BY score DESC, id ASC 让结果先按匹配分值排序，再用主键打破并列，避免页面翻页时顺序漂移。

如果只想要求前缀出现，但不要求它是唯一检索词，可以去掉 +；如果还要排除某个词，可以在布尔查询中加入带减号的条件。例如：

-- 必须出现 deploy 前缀，同时排除包含 debug 的记录
SELECT id, title
FROM search_docs
WHERE MATCH(title, content)
      AGAINST('+deploy* -debug' IN BOOLEAN MODE);

这个例子仍然只是在全文索引中组合运算符。它不会把查询变成“任意位置的字符串正则搜索”，所以不能拿它替代需要按字符、标点或任意子串匹配的 LIKE '%...%'、正则表达式或专用搜索引擎。

把检索词放进可复用的查询

业务代码通常会把用户输入拼成布尔查询。建议把“是否必选”和“是否使用前缀”作为明确的业务规则，而不是无条件给每个输入追加运算符。以下 SQL 展示一个固定模板：原始词只作为参数值传入，查询结构本身保持不变。

-- 应用层把 search_query 绑定为字符串，例如 '+deploy*'
SET @search_query = '+deploy*';

-- 复用同一 MATCH 表达式，返回分值并保持稳定排序
SELECT
    id,
    title,
    MATCH(title, content) AGAINST(@search_query IN BOOLEAN MODE) AS score
FROM search_docs
WHERE MATCH(title, content) AGAINST(@search_query IN BOOLEAN MODE) > 0
ORDER BY score DESC, id ASC
LIMIT 20;

这里用参数承载检索词，是为了让“查询结构”和“用户词”分离。应用层仍要根据产品规则处理空输入、过短输入和不允许的运算符；这属于输入协议设计，不是让数据库把任意输入都当成 SQL 语法。

区分前缀匹配与自然语言相关度

IN BOOLEAN MODE 的重点是运算符语义：可以使用必选、排除和前缀等条件。它与自然语言模式的目标不同，不能简单理解成“把自然语言搜索加上一个星号”。前缀匹配尤其适合搜索框、命令名、文档标题等需要控制候选集合的场景。

最容易混淆的地方是“词前缀”和“字符串前缀”。+deploy* 面向全文解析后的词；如果需求是命中一个词内部的任意片段，例如命中 ploy，就不能因为看到了星号而认为全文检索天然支持这种任意子串搜索。

从索引、分词和表达式三层排查空结果

当数据库里肉眼可见 deployment，查询却返回空集时，可以按下面的顺序处理。每一步都要先确认证据，再改动下一层。

1. 核对索引列。 确认表上存在覆盖 title、content 的 FULLTEXT 索引，并且 MATCH 引用的是同一组列。
2. 核对模式。 确认查询真的带有 IN BOOLEAN MODE；没有这个模式时，末尾星号不会按本文讨论的布尔前缀规则解释。
3. 核对词边界。 前缀匹配作用于全文解析出的词，不等于任意字符搜索；标点、连字符、语言分词和自定义解析器都会影响词边界。
4. 核对长度与停用词设置。 过短词或停用词可能不会进入普通全文词表。需要特殊处理时，应结合当前实例的全文相关配置和解析器选择，而不是只修改 SQL 运算符。
5. 最后拆分表达式。 先用 +deploy* 单独查询，再逐个加入排除词、短语或其他条件。一次加入多个运算符，会让问题难以归因。

-- 先使用最小表达式确认前缀条件本身是否有结果
SELECT id, title
FROM search_docs
WHERE MATCH(title, content)
      AGAINST('+deploy*' IN BOOLEAN MODE);

-- 再单独观察全文分值，避免把排序问题误判为空结果
SELECT
    id,
    MATCH(title, content) AGAINST('+deploy*' IN BOOLEAN MODE) AS score
FROM search_docs
ORDER BY id ASC;

如果最小表达式也没有结果，优先回到索引和解析器；如果最小表达式有结果，加入其他条件后才为空，就逐项检查排除词、短语和应用层组装逻辑。这个顺序比盲目扩大 LIKE 条件更容易保留全文检索的索引路径。

什么时候应该换一种搜索方案

布尔前缀匹配适合“按词前缀筛选文档”的任务，但不是所有搜索都应该塞进 MATCH AGAINST。如果需要中文或混合语言的精细分词，应先确认当前全文解析器是否符合业务词边界；如果需要任意子串、拼音、模糊纠错、联想词或复杂排序，通常要重新评估数据结构、解析器或专用搜索组件。

可以用下面的速查表做决定：

• 只需要命中以某个完整词开头的文档：优先考虑 +prefix*。
• 需要排除明确词：在布尔模式中加入 -word，并先用最小表达式确认结果。
• 需要任意字符片段：不要把 * 误当成通用通配符，评估 LIKE、专用索引或搜索服务。
• 需要中文词边界：先确认解析器和词表，再决定 SQL 写法。

小结

MySQL 布尔全文检索的前缀匹配，核心不是在 LIKE 里套一层 MATCH，而是把 +deploy* 交给 IN BOOLEAN MODE 解释。+ 负责必选，末尾 * 负责词前缀；索引列、全文解析器和应用层查询组装则决定了这个表达式能否得到预期结果。遇到空结果时，从索引列、模式、词边界到复合条件逐层缩小范围，通常比继续堆叠运算符更稳。

相关问题

MySQL 的 * 能匹配任意字符串吗？

不能。本文中的 * 是布尔全文检索词末尾的前缀运算符，作用对象是解析后的词，不是任意字符通配符。

为什么 MATCH 的列顺序也要保持一致？

因为全文索引和查询字段集合需要对应。遇到查询异常时，先让 FULLTEXT 与 MATCH 使用相同列集合和顺序，再继续排查词语规则。

前缀匹配能替代中文分词吗？

不能。前缀运算符解决的是已被全文解析器识别的词的前缀筛选，中文词边界仍由解析器和相关配置决定。