Flarum 中文搜索支持：MySQL 全文索引配置教程

前言

Flarum 默认不支持中文搜索，本文将介绍如何通过 MySQL 5.7 的 Ngram 全文索引功能，让 Flarum 实现中文分词搜索。

前提条件

• MySQL 5.7 或以上版本
• 可以修改 MySQL 配置文件
• 具备数据库操作权限

步骤一：修改 MySQL 配置

首先找到 MySQL 配置文件，通常位于 /etc/my.cnf。

在 [mysqld] 段中加入以下内容：

[mysqld]
ngram_token_size=2 

说明
ngram_token_size=2 表示按最小 2 个字符进行分词，适合中文搜索。
如果中文词汇普遍较长，可调整为 3。

保存文件后，重启 MySQL 服务使配置生效：

步骤二：重建数据库全文索引

我们需要为 posts 表和 discussions 表重建全文索引，使用 ngram 解析器 支持中文分词。

可通过 phpMyAdmin 或 MySQL 命令行 执行以下 SQL。

重要提示

• 将 YourFlarumDataBaseName 替换为你的数据库名称
• 如有表前缀（如 fl_posts、fl_discussions），请一并加上

1. 重建 posts 表索引

USE YourFlarumDataBaseName;
ALTER TABLE posts DROP INDEX content;
CREATE FULLTEXT INDEX content ON posts (content) WITH PARSER ngram;

2. 重建 discussions 表索引

USE YourFlarumDataBaseName;
ALTER TABLE discussions DROP INDEX title;
CREATE FULLTEXT INDEX title ON discussions (title) WITH PARSER ngram;

步骤三：验证效果

索引重建后，MySQL 会在后台构建索引，数据量大时需稍等片刻。

用浏览器访问 Flarum 论坛，Ctrl + F5 强制刷新，然后搜索中文关键词测试。

成功标志：可以正常搜索中文内容。

常见问题

1. DROP INDEX 报错"索引不存在"

说明该表没有默认全文索引，直接执行 CREATE FULLTEXT INDEX 即可。

2. 搜索仍然没有结果

请检查：

• MySQL 版本是否为 5.7 或以上
• 配置是否生效（执行 SHOW VARIABLES LIKE 'ngram_token_size%'; 查看）
• 索引是否创建成功（执行 SHOW INDEX FROM posts; 查看）

3. 分词效果不理想

调整 ngram_token_size 的值：

• 值越小 → 分词越细，召回率高，精确度可能降低
• 值越大 → 分词越粗，精确度高，召回率可能降低

结语

通过以上配置，利用 MySQL 自带的 Ngram 全文索引，无需额外扩展即可为 Flarum 添加中文搜索支持，轻量高效。

如有问题，欢迎留言交流。