萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MySQL 教學

MySQL 全文索引最小字元長度限制修改指南 (ft_min_word_len)

問題背景

MySQL 4.0+ 支援全文索引,但預設 **最小索引字元長度 = 4** (`ft_min_word_len = 4`)。對於英文單字合理,但對 **中文/日文/韓文** (無空格分詞、單字多為 1-2 字) 導致無法索引短詞,搜尋失效。

修改配置檔

編輯 `my.cnf` (Linux) 或 `my.ini` (Windows),在 `[mysqld]` 區段新增/修改:

[mysqld]
ft_min_word_len = 2  -- 建議設為 1 或 2,支援單字/雙字搜尋
# ft_max_word_len = 84  -- 最大長度通常無需調整
# ft_stopword_file = '' -- 可選:禁用停用詞表

生效步驟 (關鍵:必須重建索引)

  1. 修改配置檔並儲存。
  2. 重啟 MySQL 服務:`systemctl restart mysqld` / `net stop mysql && net start mysql`。
  3. 重建全文索引: 修改參數**不會自動重建現有索引**,必須執行:
    `ALTER TABLE table_name DROP INDEX idx_fulltext;`
    `ALTER TABLE table_name ADD FULLTEXT INDEX idx_fulltext (col1, col2);`
    或簡單執行:`REPAIR TABLE table_name QUICK;` (MyISAM) / `ANALYZE TABLE` (InnoDB 5.6+)。

驗證修改生效

SHOW VARIABLES LIKE 'ft_min_word_len';
-- 應顯示 Value = 2

-- 測試搜尋
SELECT * FROM articles WHERE MATCH(title, content) AGAINST('的' IN BOOLEAN MODE); -- 單字 '的' 現在可搜尋

存儲引擎差異注意

引擎全文索引支援ft_min_word_len 生效備註
MyISAM✅ 完整支援✅傳統選擇
InnoDB✅ 5.6.4+ 支援✅ 5.6+5.6 前不支援全文索引
InnoDB❌ 5.6 前❌需升級或改用 MyISAM/外部搜尋引擎

中文分詞進階建議

調整 `ft_min_word_len` 只能解決「單字可被索引」,但 **無法解決分詞語意問題** (如「資料庫」不會自動拆分為「資料」+「庫」)。生產環境建議:

  • 使用 **ngram parser** (MySQL 5.7.6+ 內建):`CREATE TABLE ... FULLTEXT INDEX (col) WITH PARSER ngram;` 自動按 bigram 分詞,無需調整 `ft_min_word_len`。
  • 整合專業搜尋引擎:**Elasticsearch + IK Analyzer**、**Solr + mmseg4j**、**Sphinx + coreseek**。
copyright © 萬盛學電腦網 all rights reserved