Laravel迁移异常：数据透视表仅单个外键设为二级键

问题描述 #

在Laravel 9.19中创建带复合主键的数据透视表endpoint_parameter，迁移中定义了两个外键（id_endpoint、id_parameter）和复合主键，但执行后phpMyAdmin 5.2.1仅显示id_endpoint为二级键，id_parameter无对应二级键及fk_parameter的BTREE索引。移除复合主键声明后，两个外键均能正常识别为二级键，多次执行迁移、清除缓存后问题仍存在，数据库为MariaDB。

解决方法 #

在迁移代码中，除设置复合主键外，需手动为第二个外键字段添加单独索引。示例代码如下：

public function up()
{
    Schema::create('endpoint_parameter', function (Blueprint $table) {
        // 定义外键字段
        $table->unsignedBigInteger('id_endpoint');
        $table->unsignedBigInteger('id_parameter');
        
        // 设置复合主键
        $table->primary(['id_endpoint', 'id_parameter']);
        
        // 手动为第二个外键添加索引
        $table->index('id_parameter');
        
        // 配置外键约束
        $table->foreign('id_endpoint')
              ->references('id')
              ->on('endpoints')
              ->onDelete('cascade');
              
        $table->foreign('id_parameter')
              ->references('id')
              ->on('parameters')
              ->onDelete('cascade');
    });
}

原因说明 #

设置复合主键时，Laravel仅会创建包含两个字段的联合主键索引，不会自动为每个外键字段生成单独的二级索引。MariaDB中复合主键的第一个字段会被纳入主键索引结构，phpMyAdmin会识别其为二级键，但第二个字段仅作为联合索引的一部分存在，不会被单独标记为二级键。手动添加id_parameter的单独索引后，phpMyAdmin就能显示对应的二级键及BTREE索引。

内容的提问来源于stack exchange，提问作者Antonio Savino