为什么MySQL中对TEXT大字段建索引必须指定前缀长度?

雨瑶姑娘_3055

雨瑶姑娘_3055

2026-10-16

402人浏览

原创

error 1170是innodb引擎强制限制,text/blob列建索引必须指定前缀长度(如content(255)),且受字符集字节影响;前缀索引仅支持left like和等值查询,%开头模糊搜索无效;全文检索应使用fulltext或外置es。

为什么mysql中对text大字段建索引必须指定前缀长度?

ERROR 1170 是硬性限制,不是配置能绕过的

执行 CREATE INDEX idx ON t (content) 时直接报 ERROR 1170 (42000): BLOB/TEXT column 'content' used in key specification without a key length,这不是 MySQL 配置没开、也不是权限问题,而是 InnoDB 引擎层的强制约束。根本原因是 TEXT 类型数据不存于主记录页内,只留 20 字节指针指向溢出页;索引结构要求键值能被完整加载进内存页(默认 16KB),而 TEXT 值长度不可控,全量索引会导致 B+ 树节点大小失控、写入性能崩塌、磁盘空间爆炸。

前缀长度单位是字符数,但实际按字节算存储开销

对 TEXT 列建索引必须写成 INDEX(content(255)) 这种形式,其中 255 是字符数(不是字节)。但在 utf8mb4 字符集下,一个中文字符占 4 字节,所以 content(255) 实际可能占用 1020 字节——这已经接近 InnoDB 默认单列索引长度上限(767 字节)。如果启用了 innodb_large_prefix,上限可升至 3072 字节,否则容易触发 Specified key was too long 错误。

  • 查当前表字符集:SHOW CREATE TABLE t,确认 CHARSET 和 COLLATE
  • 估算实际字节数:中文为主就按 ×4,英文混合按 ×2~3 粗估
  • 联合索引中含 TEXT 前缀列,该列必须放在最后,否则部分版本会建索引失败或查询效率受损

前缀索引只对 LEFT LIKE 和等值匹配有效

WHERE content LIKE 'error%' 或 WHERE content = 'exact string' 能走前缀索引;但只要出现 % 开头,比如 LIKE '%500%'、LIKE '%timeout',索引完全失效,MySQL 只能全表扫描。这时候加索引不仅没用,还拖慢 INSERT/UPDATE、浪费磁盘空间。

MySQL
MySQL

编写正确的MySQL查询,避免字符集、索引和锁方面的常见陷阱。

下载
  • 用 EXPLAIN 验证:key 列显示索引名,且 rows 显著下降才算生效
  • 如果 Extra 出现 Using filesort 或 Using where,说明没走覆盖,可能得拆查询逻辑
  • 区分度低的前缀(如日志字段前 20 字全是 {"level":"error")会让索引变成“假索引”,查出来一堆行再回表比对,IO 反而更高

真正需要模糊搜索或排序,别硬扛 TEXT + 前缀索引

如果你的业务要支持 WHERE content LIKE '%keyword%'、ORDER BY content 或精确去重,前缀索引从设计上就不满足。它既不能保证排序完整性,也无法支撑中间匹配。这时该考虑的是结构重构:

  • 把长文本内容迁出主表,用关联表或冷表存储,主表只留摘要字段(如哈希、标题、分类标签)
  • 改用 VARCHAR(16383) 替代 TEXT(在 InnoDB 行长度允许范围内),再建完整索引
  • 全文检索场景优先用 FULLTEXT 索引,但注意它不支持 = 查询,也不能替代 B+ 树做范围或排序
  • 高并发模糊搜索建议外置到 Elasticsearch 或专用检索服务,避免拖垮 OLTP 主库

前缀长度选不准、字符集算错字节、WHERE 条件没对齐最左前缀——这三个点最容易让索引形同虚设。别只看 CREATE INDEX 成功了就以为搞定了。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

mysql

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

2023.10.12

4303

8

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.27

911

4

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

2024.02.23

1109

5

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

6201

10

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

3043

4

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

2024.04.07

6180

11

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

2024.04.29

8361

6

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1130

5

sql中删除一列的命令是什么
sql中删除一列的命令是什么

在sql中,使用alter table语句可以删除一列,语法为:alter table table_name drop column column_name。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

992

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL vs MySQL
PostgreSQL vs MySQL

共1课时 | 187人学习