Laravel数据透视表迁移报错：UUID字段设unsigned引发SQL语法错误

一、先搞定你的SQL语法错误 #

你遇到的问题根源非常明确：UUID类型的字段（对应数据库里的char(36)或varchar）根本不支持unsigned属性——unsigned是给整数类型字段（比如int、bigint）用的，你给UUID字段加这个约束，MySQL自然会报语法错误。

修正你的迁移代码很简单，只需要去掉user_uid字段的->unsigned()调用就行：

public function up() {
    Schema::create('api_user', function (Blueprint $table) {
        $table->increments('id');
        $table->integer('api_id')->unsigned()->index();
        $table->foreign('api_id')->references('id')->on('apis')->onDelete('cascade');
        // 去掉unsigned，因为uuid()会创建char(36)类型，不支持该属性
        $table->uuid('user_uid')->index();
        $table->foreign('user_uid')->references('uid')->on('users')->onDelete('cascade');
        $table->timestamps();
    });
}

如果你的Laravel版本在7.0以上，还可以用更简洁的foreignUuid方法来处理UUID外键，它会自动帮你处理字段类型和约束：

$table->foreignUuid('user_uid')->references('uid')->on('users')->onDelete('cascade');

另外补充个小技巧：多对多透视表其实不一定需要自增id字段，你可以用两个关联字段作为复合主键，这样更符合多对多关系的设计：

// 去掉$table->increments('id');
$table->primary(['api_id', 'user_uid']);

二、除了Laravel-5-Generators-Extended，还有这些创建透视表的方法 #

1. 手动编写迁移（最常用、最灵活） #

这就是你现在尝试的方式，只要遵循Laravel的命名规范（两个关联模型的表名按字母顺序拼接，比如api_user而不是user_api），然后在迁移里定义对应的外键字段和约束即可。这种方式完全不需要依赖第三方包，可控性最强。

2. 通过Artisan命令生成迁移骨架后修改 #

先运行Artisan命令生成一个空的迁移文件：

php artisan make:migration create_api_user_table

然后打开生成的迁移文件，手动添加你需要的字段、外键和其他约束——本质和第一种方法一样，但命令帮你省了创建文件的步骤。

3. 利用Laravel的关联定义辅助迁移 #

在你的两个模型（比如Api和User）的belongsToMany关系里，你可以先明确透视表的字段：

// 在Api模型中
public function users()
{
    return $this->belongsToMany(User::class, 'api_user', 'api_id', 'user_uid')
                ->withTimestamps(); // 如果透视表需要created_at/updated_at
}

然后在迁移文件里，对应这个关系来编写字段——这种方式能让模型关系和迁移结构保持一致，避免字段名不匹配的问题。

4. 使用Laravel的Schema构建器快捷方法 #

除了前面提到的foreignUuid，Laravel还提供了其他快捷方法来简化外键定义，比如对于整数类型的外键，可以用：

$table->foreignId('api_id')->constrained('apis')->onDelete('cascade');

这个方法会自动创建unsigned bigint类型的字段，并关联到目标表的主键，比手动写integer()->unsigned()->foreign()更简洁。

内容的提问来源于stack exchange，提问作者M. Badovsky