如何修复 MySql：索引列大小太大（Laravel 迁移）

Posted 2023-02-24

【中文标题】如何修复 MySql：索引列大小太大（Laravel 迁移）

【英文标题】：How to fix MySql: index column size too large (Laravel migrate)

【发布时间】：2017-06-21 22:39:13

【问题描述】：

我复制了一个带有安装 Debian、nginx、phpMyAdmin 的 vagrant box 的项目。在新项目中，Laravel 的 php artisan migrate 不再工作，我收到错误：

[Illuminate\Database\QueryException]                                                                                                                                      
  SQLSTATE[HY000]: General error: 1709 Index column size too large. The maximum column size is 767 bytes. (SQL: alter table `courses` add unique `courses_name_unique`(`na  
  me`))

当我对工作项目数据库进行转储（结构+数据）并将其导入数据库时​​给出迁移错误，然后一切正常，它会创建所有表并导入数据..

如何固定大小以便我可以运行 migrate 方法？

【问题讨论】：

设置键的长度：alter table courses add unique courses_name_unique (FIELDNAME(299));

@BerndBuffen 我想使用 Laravel 迁移方法。该方法创建表并失败。为什么迁移在数据库服务器 A 而不是 B 上工作？是否有设置不正确？

您可能正在使用不同的字符集。虽然 varchar(255) 可能会使用 utf8 进行索引 - 它会因 utf8mb4 而失败

@PaulSpiegel 你是对的，迁移命令在工作服务器上创建utf8_unicode_ci，在不工作的服务器上创建utf8mb4_unicode_ci 排序规则。如何让数据库默认创建正确的字符集？

如何在迁移脚本中创建数据库？

【参考方案1】：

在 App\Providers\AppServiceProvider.php 中，导入 Schema

use Illuminate\Support\Facades\Schema;

并在boot() 函数中添加这一行：

Schema::defaultStringLength(191);

【参考方案2】：

对于 Laravel 5.5 或更高版本，将 config/database.php 文件引擎更改为 InnoDB ROW_FORMAT=DYNAMIC：

'connections' => [
    ...
    'mysql' => [
        ...
        'engine' => 'InnoDB ROW_FORMAT=DYNAMIC',
 ]]

感谢 laracasts：https://laracasts.com/discuss/channels/eloquent/migrations-and-table-options-row-format

【参考方案3】：

对于 mariadb，使用以下配置更新您的 *my.cnf 文件，

innodb_default_row_format=dynamic
innodb_file_format=barracuda
innodb_file_per_table=true
innodb_large_prefix=true

然后，您必须重新启动mariadb 服务才能使更新的配置生效。

【讨论】：

谢谢！这很有帮助。

感谢您指出 row format 选项 - 我有其他配置，但没有，所以我的密钥长度停留在 767。

对我来说，我必须在我的 Ubuntu 服务器 18.04 上编辑 /etc/mysql/mariadb.conf.d/50-mysql_innodb_custom.cnf 并添加行 innodb_default_row_format=dynamic

这不行！！我添加了这些行，我的 mariadb 停止工作！

【参考方案4】：

默认情况下，MySQL 使用字符集 utf8，这意味着我们每 1 个字符使用 3 个字节。这意味着，varchar(10) 的列类型使用 30 个字节，导致紧凑行格式的最大前缀大小等于 varchar(255)。即 255 * 3bytes = 765 字节，即比最大值 767 字节少两个字节。

将 innodb_large_prefix 设置为 on 并使用行格式 COMPRESSED 或 DYNAMIC，您可以将最大前缀字符大小增加到 65536 字节而不是 767 字节。下图显示了 InnoDB 大前缀和 [COMPRESSED| 的最大字符长度动态] 行格式。这些值（对于 utf8mb4 除外）高于表的最大行大小，因此无法达到这些限制

更多信息在这里 https://discuss.pivotal.io/hc/en-us/articles/115004086747-Apps-are-down-due-to-the-Maximum-Column-Size-is-767-bytes-Constraint-in-MySQL

【参考方案5】：

它适用于 5.5.52-MariaDB。

将所有编码设置为utf8_general_ci（服务器、数据库、连接）。

【讨论】：

utf8_general_ci 已弃用。请改用 utf8mb4。

【参考方案6】：

我刚刚做的也有这个问题，在数据库连接脚本中从 utf8mb4_unicode_ci 恢复为 utf8_unicode_ci

【讨论】：

utf8_general_ci 已弃用。请改用 utf8mb4。

在 Laravel 8 中，我应用了这个建议 (utf8 / utf8_unicode_ci)，它与 ​​MySQL 5.7.36 完美配合

【参考方案7】：

三个解决方案，每个都有一个缺点：

MySQL 5.7 避免了这个问题。考虑升级。

VARCHAR(255) 通常 var 大于 必要。如果你可以安全地缩小到 191 或更少，错误就会消失。

切换到 utf8（从 utf8mb4），如果你不需要中文或 Emoji。

【讨论】：

更多关于“191”的信息在mysql.rjweb.org/doc.php/…

> "MySQL 5.7 避免了这个问题"，你的意思是因为他们有innodb_large_prefixenabled by default?

@guessimtoolate - 是的。 （以及一些相关的东西；见我的链接）

【参考方案8】：

您可以在错误消息中看到 - “最大列大小为 767 字节”，如果您想在其上创建索引。使用 utf8 时，VARCHAR(255) 列最多可占用 765 (255*3) 字节，使用 utf8mb4 时可占用 1020 (255*4) 字节。这是因为在 MySQL 中 utf8 最多占用 3 个字节，utf8mb4 最多占用 4 个字节（真正的 UTF8）。因此使用utf8mb4 创建VARCHAR(255)（唯一）索引将失败。

这是您解决问题的选项：

在my.ini中设置默认排序规则：

collation_server=utf8_unicode_ci
character_set_server=utf8

创建时为数据库设置默认排序规则：

CREATE DATABASE IF NOT EXISTS `your_db` COLLATE 'utf8_unicode_ci'

为表/列设置默认排序规则。 （我不建议这样做）

将列大小更改为 190 (varchar(190)) 或更小。

Laravel 5.4 修复

Mysql 服务器配置被 Laravel 的迁移命令覆盖。它将排序规则和字符集设置为配置的版本。

在位于config/database.php的数据库配置文件中更改数据库引擎的charset和collation字段。

..
'mysql' => [
            'driver' => 'mysql',
            'host' => env('DB_HOST', '127.0.0.1'),
            'port' => env('DB_PORT', '3306'),
            'database' => env('DB_DATABASE', 'forge'),
            'username' => env('DB_USERNAME', 'forge'),
            'password' => env('DB_PASSWORD', ''),
            //'charset' => 'utf8mb4',
            //'collation' => 'utf8mb4_unicode_ci',
            'charset'   => 'utf8',
            'collation' => 'utf8_unicode_ci',
            'prefix' => '',
            'strict' => true,
            'engine' => null,
        ],
..

【讨论】：

谢谢，你让我走上了正轨！您提供的服务器配置不起作用，因为最新版本的 laravel (5.4) 更改了默认排序规则和字符集。我更新了你的答案，还包括 Laravel 修复。

或者你可以按照这个更好的答案：***.com/questions/23786359/…