Laravel 5.7 “1071 Specified key was too long” 错误终极解决方案

最新推荐文章于 2025-06-12 10:42:12 发布
原创 最新推荐文章于 2025-06-12 10:42:12 发布 · 2.3k 阅读 · 2 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#Laravel #Mysql #1071 Specified

前言

在Laravel中进行数据迁移的时候，经常会碰到1071 Specified key was too long; max key length is 1000 bytes的错误，让人头疼不已。不过好在办法总比问题多，下面就让我们通过修改两个文件来彻底解决这个问题。

Step 1

修改AppServiceProvider.php文件，在boot()方法中加入如下代码：

...
use Illuminate\Support\Facades\Schema;
...
public function boot
最低0.47元/天 解锁文章

200万优质内容无限畅学
MySQL出现Specified key was too long； max key length is 3072 bytes解决方案
weixin_43178406的博客
06-21 2万+
本文主要介绍了MySQL出现Specified key was too long; max key length is 3072 bytes，希望能对学习MySQL的同学们有所帮助。 文章目录 1. 问题描述 2. 原因分析 3. 解决方案
[Err] 1071 - Specified key was too long; max key length is 767 bytes
：）
04-07 1万+
另外一台服务器到期了 所以新购了一台服务器 今天安装好了环境 准备将数据迁移过来 执行导入SQL：source /data/sql/77dh_20200407_2034.txt 发现报错如下 ERROR 1071 (42000): Specified key was too long; max key length is 767 bytes 搜索得知需要将如下变量设置为如下值： innodb...
解决laravel-admin安装报错1071 Specified key was too long问题
小坚的技术博客
02-19 1552
在执行命令安装的时候，如果你使用的数据库是。
1071 - Specified key was too long； max key length is 3072 bytes Mysql报错解决方法
代妈炼金术师
01-09 1万+
max key length is 3072 bytes” 是在MySQL数据库中创建索引时可能出现的问题，通常出现在尝试创建一个过长的唯一键（UNIQUE KEY）或主键（PRIMARY KEY）时。例如，在使用utf8字符集时，每个字符可能占用3个字节，那么对于innodb表，索引键的最大长度大约为1000个字符左右（因为3072 / 3 ≈ 1024）。：如果不需要对整个字段进行索引，可以选择只对部分字段建立索引，或者创建覆盖索引（覆盖索引仅包含查询所需的列）。：检查并适当缩短构成索引的字段长度。
Specified key was too long； max key length is 767 bytes
weixin_52568278的博客
06-12 606
则提供了具体实现这种支持的文件格式基础（包括相关的数据存储、索引管理等底层机制）。这样一来，原本因为索引键长度超过。两个设置结合起来，实际上是让 InnoDB 存储引擎切换到一种能够支持更长索引键长度的模式。字节限制而报错的场景，在满足其他相关条件（如行格式设置正确等，有时还可能需要修改字符集为。负责开启允许大前缀（广义可理解为对索引键长度限制的宽松化倾向）的“开关”，而。等，具体根据实际情况）时，就能够顺利创建索引，从而解决。
建表语句错误：[Err] 1071 - Specified key was too long; max key length is 767 bytes
麦子的博客
10-29 1万+
今天复制quartz给出的sql在mysql执行。 [Err] 1071 - Specified key was too long; max key length is 767 bytes 主键字段过长。 1.在mysql 5.5.3之前，mysql的InnoDB引擎，要求设置的主键长度不得超过767bytes。 mysql的MyIsam引擎的主键长度不得超过1000 bytes。 2.在...
数据库错误[ERR] 1071 - Specified key was too long； max key length is 1000 bytes
m0_71751187的博客
06-11 1191
把default-storage-engine=MyISAM改为default-storage-engine=INNODB即可。因为默认使用MyISAM，MyLSAM限制1000 bytes，超出报错，将Mysql改为Innodb即可。试了还是有问题，直接启动不了了。因为mysql8取消了这个配置。环境：phpstudy的mysql8。
laravel mysql 1071_Laravel框架执行数据库偏移报错1071 Specified key was too long; max key length is 1000 bytes的几...
weixin_39895977的博客
02-06 274
最近在自学Laravel框架，各种坑，各种报错，真的是一把辛酸一把泪，不知道大家有没有遇到像我这样的情况：每次新安装的Laravel，在执行数据库迁移操作时都会报错提示一个有关于字符串长度的报错，原因：字段太长导致无法加索引。网上有许多同类的人和我遇到了，有的人说是MySQL的版本问题，但我尝试发现就算是用MySQL8.0版本都无济于事，那么我就整理一下所有我遇到的解决方法一一列出，希望能帮到你。...
Laravel 创建数据表报错：Syntax error or access violation: 1071 Specified key was too long
夏已微凉、
08-31 589
Laravel 创建数据表报错：Syntax error or access violation: 1071 Specified key was too long
jseesite4 脚本执行索引在MySQL 5.7 提示Specified key was too long; max key length is 3072 bytes的解决
热门推荐
zhoujans的专栏
02-22 1万+
Error executing: CREATE INDEX idx_bpm_form_pcs ON js_bpm_form (parent_codes ASC) . Cause: com.mysql.jdbc.exceptions.jdbc4.MySQLSyntaxErrorException: Specified key was too long; max key length is 3072...
laravel5.7 migrate 时报错 Specified key was too long error 解决方案
魏亚林的csdn
01-16 425
今天在数据迁移时突然报了 Specified key was too long error 的错，解决掉之后就把这个问题记录下来。 报错原因 Laravel 5.4 +  默认使用 utf8mb4 字符编码，之前使用的是 utf8 编码 我mysql数据库使用的是 utf8 编码，支持的最大字符长度为3字节，如果遇到4字节的宽字符就会出现插入异常。 注意：三个字节 utf8 最大能编码的...
laravel Specified key was too long 解决方案
ROVAST的专栏
05-02 1353
参考地址 https://laravel.com/docs/master/migrations#creating-indexes http://www.cnblogs.com/betx/p/6544090.html 解决办法： Index Lengths & MySQL / MariaDB Laravel uses the utf8mb4 character s
1071 - Specified key was too long； max key length is 767 bytes
csdn565973850的博客
03-30 6770
1071 - Specified key was too long; max key length is 767 bytes 问题处理
mysql [Err] 1071 - Specified key was too long； max key length is 767 bytes
Vv的博客
02-19 5279
查找的资料： https://blog.csdn.net/u010030022/article/details/80967516https://blog.csdn.net/ACMAIN_CHM/article/details/4174186https://www.cnblogs.com/kerrycode/p/9680881.html 一、问题 在其他数据库导出数据到新数据库，出现[Err]...
MySQL报错 error(1071: Specified key was too long； max key length is 767 bytes)
neil12138的博客
11-19 2614
error(1071: Specified key was too long; max key length is 767 bytes) lastQuery: ALTER TABLE account MODIFY COLUMN name varchar(255) not null DEFAULT ‘’;. name这个字段上是建了索引的。类型是varchar(255) 这个报错的意思是说name这个字段允许的字节总数已经超过了767， 首先这个255是代表字符数，不是字节总数。也就是说name最多能存放25
[Err] 1071 - Specified key was too long； max key length is 767 bytes，【各版本mysql均已解决】
君临天下tjm的博客
12-28 8493
一般在MySQL 5.7及以上版本不会遇到此问题，只有在MySQL 5.6版本会遇到此问题，建议MySQL 5.6 升级到MySQL 5.7，因为MySQL 5.6 修改比较麻烦。此参数控制索引前缀长度的，不开启最长的长度是 765byte，开启最长3072byte，一般出现此报错的数据库版本是小于MYSQL5.7，同时不同的版本开启的方式也略有不同。innodb_default_row_format=dynamic (默认是dynamic)需要调整的参数的默认值是符合要求。
MySQL错误“Specified key was too long； max key length is 1000 bytes”的解决办法
ideal-lingyun
12-11 2804
MySQL错误“Specified key was too long; max key length is 1000 bytes”的解决办法
MySQL错误“Specified key was too long; max key length is 1000 bytes”的解决办法
weixin_34018169的博客
12-09 930
MySQL错误“Specified key was too long; max key length is 1000 bytes”的解决办法 经过查询才知道，是Mysql的字段设置的太长了，于是我把这两个字段的长度改了一下就好了。 建立索引时，数据库计算key的长度是累加所有Index用到的字段的char长度后再按下面比例乘起来不能超过限定的key长度1000： ...
laravel-admin安装出现错误1071 Specified key was too long 造成这个问题的原因是数据库创建特殊字符过长问题
YMB_jack的博客
06-28 588
laravel-admin安装出现错误1071 Specified key was too long
查询错误: #1071 - Specified key was too long; max key length is 1000 bytes
最新发布
08-10
<think>我们正在处理MySQL错误1071：指定的键太长，最大键长度是767字节（或1000字节，取决于具体错误信息）。这个错误通常发生在创建索引时，索引列的总长度超过了MySQL引擎允许的最大索引长度限制。 根据引用[1][2][3][4]，我们可以总结以下几点： 1. 错误原因：MySQL的InnoDB存储引擎对索引键的最大长度有限制，默认是767字节（对于旧版本MySQL或特定配置）。在MySQL 5.7及以后版本，可以通过启用innodb_large_prefix参数来扩展这个限制（最大可到3072字节），但需要满足表使用DYNAMIC或COMPRESSED行格式，且文件格式为Barracuda。 2. 计算索引长度：索引键长度是索引中所有列的长度的总和。对于字符串列，其长度取决于字符集和列定义的长度。例如，一个varchar(255)列使用utf8mb4字符集（每个字符最多4字节），那么该列的最大长度是255*4=1020字节，这已经超过了767字节。 3. 解决方法： a. 减少索引列的长度：比如将varchar(255)改为varchar(190)，因为190*4=760<767（注意：实际计算时，varchar还需要1-2个字节存储长度信息，但一般忽略不计）。 b. 修改索引：只对列的前缀部分建立索引（前缀索引），例如：`KEY (column_name(191))`，这样只取前191个字符（utf8mb4下191*4=764<767）。 c. 升级MySQL版本（引用[5]）：MySQL 5.7.7及以上版本默认启用了innodb_large_prefix，最大索引长度可达到3072字节。因此，升级到新版本可以避免此问题。 d. 修改表配置：将表的行格式设置为DYNAMIC或COMPRESSED，并确保文件格式为Barracuda（需要InnoDB支持），同时启用innodb_large_prefix（在MySQL 5.6和5.7中需要显式启用，MySQL 8.0中已默认启用且忽略该参数）。 4. 注意：在MySQL 8.0中，innodb_large_prefix参数已被移除，默认支持大索引（最大3072字节），且默认行格式为Dynamic。 具体到用户的问题，错误信息中提示最大键长度是1000字节（而不是常见的767字节），这可能是因为用户使用的是MyISAM引擎（MyISAM引擎的最大索引长度是1000字节）或者特定配置的InnoDB。但根据错误号1071，通常是InnoDB引擎。不过，引用中并没有提到1000字节的情况，所以我们按常见情况处理。 解决方案步骤： 1. 确认存储引擎和当前配置： ```sql SHOW VARIABLES LIKE 'innodb_large_prefix'; SHOW VARIABLES LIKE 'innodb_file_format'; SHOW VARIABLES LIKE 'innodb_file_per_table'; SHOW TABLE STATUS LIKE '表名'\G; -- 查看表的行格式 ``` 2. 如果使用的是InnoDB引擎，可以尝试以下方法之一： **方法一：修改列定义（减少长度）** 将导致问题的列的长度减小，例如从varchar(255)改为varchar(190)（对于utf8mb4，190*4=760<767）。 **方法二：创建前缀索引** 在创建索引时，指定使用列的前缀部分，例如： ```sql CREATE INDEX index_name ON table_name (column_name(191)); ``` 注意：191这个数字是计算出来的，确保191*每个字符最大字节数<=767。对于utf8mb4，191*4=764<767。 **方法三：启用大前缀索引（需要满足条件）** 如果MySQL版本是5.6或5.7，可以尝试启用大前缀索引： ```sql SET GLOBAL innodb_file_format = Barracuda; SET GLOBAL innodb_large_prefix = 1; ``` 然后修改表的行格式为DYNAMIC： ```sql ALTER TABLE 表名 ROW_FORMAT=DYNAMIC; ``` 之后重新创建索引。 **方法四：升级MySQL版本** 如引用[5]所述，升级到MySQL 8.0可以避免此问题，因为8.0默认支持大索引。 3. 如果使用的是MyISAM引擎，最大索引长度是1000字节，那么需要减少索引列的总长度，或者使用前缀索引。 根据错误信息中提到的1000字节，有可能用户使用的是MyISAM引擎。因此，我们还需要确认表的存储引擎。 确认引擎： ```sql SHOW CREATE TABLE 表名; ``` 如果引擎是MyISAM，那么最大索引长度是1000字节，那么同样需要减少列长度或使用前缀索引。 总结步骤： 1. 确定表使用的存储引擎。 2. 计算索引列的总字节数（考虑字符集）。 3. 根据存储引擎的最大索引长度限制（InnoDB默认767，启用大前缀后3072；MyISAM为1000），选择以下方法： - 减少列定义的长度 - 使用前缀索引 - 修改表配置（仅InnoDB）启用大前缀索引 - 升级MySQL（特别是升级到8.0） 示例操作（以InnoDB为例，且错误为767字节限制）： 假设表名为`test_table`，有一个`varchar(512)`的列`a`，字符集为utf8mb4，现在要将其设为主键（或索引）： - 直接创建会报错，因为512*4=2048>767。 - 我们可以改为使用前缀索引（这里不能直接修改主键，但如果是普通索引可以）： 如果该列不是主键，可以： ```sql CREATE INDEX idx_a ON test_table(a(191)); -- 取前191个字符 ``` 如果是主键，则不能使用前缀索引（主键必须为完整列），所以只能修改列定义： ```sql ALTER TABLE test_table MODIFY a varchar(191) PRIMARY KEY; -- 但注意，这样会改变列的长度，可能影响数据 ``` 对于主键，如果无法改变列长度，且不能使用前缀索引，那么只能考虑启用大前缀索引（需要MySQL版本支持）或者升级MySQL。 如果错误信息是1000字节，那么可能是MyISAM引擎，那么最大索引长度1000字节，同样需要计算列的总字节数，并调整列长度或使用前缀索引。 请根据实际情况选择合适的方法。</think>### MySQL Error #1071: Specified Key Too Long 解决方案 #### 错误原因分析 当MySQL创建索引时，索引键的总长度超过存储引擎限制时会出现此错误： 1. **InnoDB引擎**：默认最大索引长度为 **767字节**（MySQL 5.6/5.7）或 **3072字节**（MySQL 8.0+） 2. **MyISAM引擎**：最大索引长度为 **1000字节** 3. **根本原因**：索引列的总字节数 = 列长度 × 字符集单字符最大字节数 例如：`VARCHAR(255)` 使用 `utf8mb4` 字符集（单字符4字节）时，最大占用 `255 × 4 = 1020字节`[^4] --- #### 解决方法 ##### 方法一：缩短索引列长度（推荐） ```sql -- 示例：将 varchar(255) 改为 varchar(191) ALTER TABLE your_table MODIFY COLUMN problem_column VARCHAR(191); ``` - **计算依据**：`191 × 4 = 764字节 < 767字节`（utf8mb4字符集）[^4] ##### 方法二：创建前缀索引 ```sql -- 仅索引前100个字符 CREATE INDEX idx_name ON your_table (problem_column(100)); ``` - **适用场景**：当完整列索引非必需时 - **长度计算**：`100 × 4 = 400字节 < 767字节` ##### 方法三：启用大索引支持（MySQL 5.6/5.7） ```sql SET GLOBAL innodb_large_prefix = 1; -- 启用大索引 SET GLOBAL innodb_file_format = Barracuda; -- 修改文件格式 ALTER TABLE your_table ROW_FORMAT=DYNAMIC; -- 更改行格式 ``` - **要求**： - MySQL ≥ 5.6.3 - `innodb_file_per_table=ON` - 表使用 `DYNAMIC` 或 `COMPRESSED` 行格式[^2] ##### 方法四：升级MySQL版本（终极方案） - **MySQL 8.0+** 默认支持最大 **3072字节** 索引 （如引用[5]案例，升级后问题解决）[^5] --- #### 操作步骤示例 以修复 `users` 表的 `email` 列索引为例： ```sql -- 步骤1：检查当前列定义 SHOW CREATE TABLE users; -- 步骤2：修改列长度 (假设原为 VARCHAR(255)) ALTER TABLE users MODIFY email VARCHAR(191) NOT NULL; -- 步骤3：重建索引 CREATE UNIQUE INDEX idx_email ON users(email); ``` --- #### 预防措施 1. **设计规范**： - `utf8mb4` 字符集的列长度 ≤ 191 - `latin1` 字符集的列长度 ≤ 767 2. **索引策略**： ```sql -- 多列索引时控制总长度 CREATE INDEX idx_multi ON table ( col1(50), -- 200字节 (utf8mb4) col2(100) -- 400字节 (utf8mb4) ); -- 总计 600字节 < 767 ``` 3. **版本选择**：新项目建议直接使用 MySQL 8.0+
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值