CodeIgniter 4迁移建表时提示‘Cannot add foreign key constraint’如何解决？

我正在学习CodeIgniter 4，使用Migration创建数据表，以下是我的迁移代码：

<?php

namespace App\Database\Migrations;

use CodeIgniter\Database\Migration;

class CreateDivisionTable extends Migration
{
    public function up()
    {
        $this->forge->addField([

            'id' => [

                'type' => 'INT',
                'constraint' => 7,
                'unsigned' => true,
                'auto_increment' => true
            ],

            'name' => [

                'type' => 'VARCHAR',
                'constraint' => '128'

            ],

            'entity_id' => [
                'type' => 'INT',
                'contraint' => '7'
            ]


        ]);
        $this->forge->addPrimaryKey('id');
        $this->forge->addForeignKey('entity_id', 'entities', 'id');
        $this->forge->createTable('divisions');
        //
    }

    public function down()
    {
        $this->forge->dropTable('divisions');
    }
}

运行时出现如下错误：

Cannot add foreign key constraint

at SYSTEMPATH/Database/BaseConnection.php:646

Backtrace:
  1    SYSTEMPATH/Database/Forge.php:546
       CodeIgniter\Database\BaseConnection()->query('CREATE TABLE `divisions` (
        `id` INT(7) UNSIGNED NOT NULL AUTO_INCREMENT,
        `name` VARCHAR(128) NOT NULL,
        `entity_id` INT NOT NULL,
        CONSTRAINT `pk_divisions` PRIMARY KEY(`id`),
        CONSTRAINT `divisions_entity_id_foreign` FOREIGN KEY (`entity_id`) REFERENCES `entities`(`id`)
) DEFAULT CHARACTER SET = utf8 COLLATE = utf8_general_ci')

我的entities表已存在主键id，注释掉addForeignKey()方法后可正常创建表，但我需要设置外键，请问该如何解决这个问题？

从错误信息和代码来看，主要有几个核心问题需要修正：

1. 修正字段拼写错误 #

你的entity_id字段里把constraint拼成了contraint，导致数据库生成的字段是INT NOT NULL，缺失了长度和无符号属性，和entities表的id字段类型不匹配。

2. 外键字段必须与关联主键完全一致 #

外键字段的数据类型、长度、无符号属性必须和关联表的主键完全匹配。从你的代码推断，entities表的id是INT(7) UNSIGNED，所以entity_id必须同步这个定义。

3. 确保数据库引擎支持外键 #

MyISAM引擎不支持外键，需要确保entities表和divisions表都使用InnoDB引擎（CodeIgniter 4默认是InnoDB，但建议显式指定避免异常）。

修正后的迁移代码 #

<?php

namespace App\Database\Migrations;

use CodeIgniter\Database\Migration;

class CreateDivisionTable extends Migration
{
    public function up()
    {
        $this->forge->addField([
            'id' => [
                'type' => 'INT',
                'constraint' => 7,
                'unsigned' => true,
                'auto_increment' => true
            ],
            'name' => [
                'type' => 'VARCHAR',
                'constraint' => '128'
            ],
            'entity_id' => [
                'type' => 'INT',
                'constraint' => 7,
                'unsigned' => true, // 和entities.id属性完全一致
                'null' => false // 根据业务需求设置是否允许为空
            ]
        ]);
        $this->forge->addPrimaryKey('id');
        // 添加外键级联操作（可选，根据业务逻辑调整）
        $this->forge->addForeignKey(
            'entity_id', 
            'entities', 
            'id',
            'CASCADE', // 关联记录删除时，自动删除当前表对应记录
            'CASCADE'  // 关联主键更新时，自动同步当前表外键值
        );
        // 显式指定引擎为InnoDB
        $this->forge->createTable('divisions', true, ['engine' => 'InnoDB']);
    }

    public function down()
    {
        // 删除表前先移除外键约束，避免报错
        $this->forge->dropForeignKey('divisions', 'divisions_entity_id_foreign');
        $this->forge->dropTable('divisions');
    }
}

额外检查项 #

• 确认entities表的id字段确实是INT(7) UNSIGNED AUTO_INCREMENT类型
• 确保entities表的迁移执行顺序在divisions之前（CodeIgniter按迁移文件名的时间戳排序执行）
• 检查MySQL的foreign_key_checks参数是否开启（默认开启，若关闭则无法创建外键）

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