MySQL 5.7中/*!50100 */注释失效，ngram全文索引无法使用

可能的原因及对应解决方案 #

• MySQL版本不达标
  ngram全文解析器是MySQL 5.7.6及以上版本才引入的特性。如果你的MySQL版本低于5.7.6，WITH PARSER ngram会被当作版本条件注释忽略，索引实际是普通全文索引，无法处理中文分词逻辑。
  验证版本：执行SELECT VERSION();，若版本低于5.7.6，需升级MySQL。

• 存储引擎不支持
  仅InnoDB（5.7.6+）和MyISAM引擎支持ngram解析器。如果表使用了MEMORY等其他引擎，全文索引无法正常工作。
  检查存储引擎：执行SHOW TABLE STATUS LIKE '你的表名'\G，确认Engine字段为InnoDB或MyISAM。

• 搜索语法或分词规则不匹配
  使用ngram索引时必须用MATCH(字段名) AGAINST('搜索关键词')的语法，且默认ngram_token_size为2，单个汉字可能无法匹配（默认按2个字符分词）。
  正确查询示例：

  SELECT * FROM books WHERE MATCH(book_name) AGAINST('编程');
  

  若需支持单个字搜索，可修改配置：在my.cnf中添加ngram_token_size=1，重启MySQL后重建索引。

• 字符集配置错误
  表或字段的字符集需设置为utf8mb4或utf8，否则中文分词会出现异常。
  检查字符集：执行SHOW CREATE TABLE 你的表名;，确认表的CHARSET为utf8mb4或utf8。

验证索引生效状态 #

执行EXPLAIN SELECT * FROM books WHERE MATCH(book_name) AGAINST('搜索关键词');，若type字段显示fulltext，说明索引已正常启用。

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