MySQL 8.12中外键约束提示列不兼容问题排查

你的怀疑完全正确——这个错误的根源就是两张表的字符集和排序规则不匹配。MySQL对外键约束的要求非常严格：关联列除了数据类型、长度、非空属性必须一致外，字符集和排序规则也得完全相同。

问题细节 #

• users表用的是utf8_unicode_ci排序规则，对应字符集是utf8（MySQL里的utf8实际是utf8mb3，仅支持基础Unicode字符）
• user_slugs表用的是utf8mb4_unicode_ci排序规则，对应字符集是utf8mb4（支持完整Unicode，包括emoji等特殊字符）
  两者字符集本质不同，即使排序规则名称类似，也无法建立外键关联。

解决方案：统一两张表的字符集和排序规则 #

方案1：统一为utf8mb4_unicode_ci（推荐） #

utf8mb4是MySQL当前推荐的字符集，能避免后续特殊字符存储的问题，执行以下SQL修改users表：

ALTER TABLE users CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

这条命令会将表的默认字符集、排序规则，以及所有字符类型的列（包括id列）批量转换为utf8mb4_unicode_ci。

修改完成后，重新添加外键约束（如果Laravel迁移自动执行失败，可手动执行）：

ALTER TABLE user_slugs ADD CONSTRAINT fk_user_slugs_user_id FOREIGN KEY (user_id) REFERENCES users(id);

方案2：统一为utf8_unicode_ci（仅兼容旧场景） #

如果必须保留utf8字符集，可修改user_slugs表：

ALTER TABLE user_slugs CONVERT TO CHARACTER SET utf8 COLLATE utf8_unicode_ci;

之后再添加外键约束即可。

本地环境正常的原因 #

大概率是本地MySQL的默认字符集和排序规则与生产环境不一致。比如本地默认配置为utf8mb4，Laravel生成的两张表都继承了默认值，所以字符集匹配；而生产环境中users表可能被手动修改过，或者MySQL全局配置不同，导致两张表字符集出现差异。

Laravel迁移层面避免后续问题 #

在迁移文件中显式指定表的字符集和排序规则，避免依赖MySQL的默认配置：

Schema::create('users', function (Blueprint $table) {
    $table->id();
    // 其他字段定义...
    $table->charset = 'utf8mb4';
    $table->collation = 'utf8mb4_unicode_ci';
});

Schema::create('user_slugs', function (Blueprint $table) {
    $table->id();
    $table->string('user_id');
    // 其他字段定义...
    $table->foreign('user_id')->references('id')->on('users');
    $table->charset = 'utf8mb4';
    $table->collation = 'utf8mb4_unicode_ci';
});

内容的提问来源于stack exchange，提问作者Kristi Jorgji