PrestaShop自定义模块建表时MySQL外键约束添加失败如何解决

核心问题原因 #

• 字符串拼接语法错误：你给出的报错代码行将表名拆分到两行书写，且带有缩进空格，PHP拼接SQL时会把换行、缩进空格一同带入生成的SQL语句，最终生成的关联表名变成`ps_ product`（前缀和product之间存在多余空白字符），数据库无法找到对应表，触发外键创建失败。
• 字段属性不匹配：PrestaShop原生商品表product的主键id_product默认类型为INT UNSIGNED NOT NULL，你定义的id_product字段为普通INT(10)类型，外键要求关联双方字段的类型、有无符号、是否为空的属性完全一致，属性不匹配也会触发报错。

修复步骤 #

1. 修正SQL拼接的换行错误，保证表名字符串连续无多余空白
2. 调整id_product字段类型和原生表属性保持一致，建议同时调整id_group字段属性和关联的pp_group表id字段保持一致

修复后的pp_project建表代码参考 #

$sqls[] = 'CREATE TABLE IF NOT EXISTS `' . _DB_PREFIX_ . 'pp_project` (
    `id` INT NOT NULL AUTO_INCREMENT,
    `id_group` INT NOT NULL, -- 和pp_group表的id属性保持一致
    `id_product` INT UNSIGNED NOT NULL, -- 和原生product表的id_product属性对齐
    `name` VARCHAR(255),
    `height` INT,
    `width` INT,
    `file` VARCHAR(255),
    `class_name` VARCHAR(255),
    PRIMARY KEY (`id`),
    FOREIGN KEY (`id_product`) REFERENCES `' ._DB_PREFIX_. 'product`(`id_product`) ON DELETE CASCADE,
    FOREIGN KEY (`id_group`) REFERENCES `' ._DB_PREFIX_. 'pp_group`(`id`) ON DELETE CASCADE
) ENGINE=' . _MYSQL_ENGINE_ . ' DEFAULT CHARSET=UTF8mb4';

如果业务允许id_group、id_product为空，可以去掉NOT NULL约束，仅保留字段类型和关联字段对齐即可，即id_group为INT，id_product为INT UNSIGNED。

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