MariaDB外键约束创建失败：同类型字段仍报错排查

针对你遇到的外键创建失败问题，结合环境差异和已做的尝试，给出以下排查方向和解决方案：

可能的问题点及对应解决方法 #

1. 拆分ALTER语句，避免复合操作冲突 #

不要在同一条ALTER TABLE中同时添加字段和外键，部分MariaDB版本对复合ALTER操作的处理存在兼容性问题。将操作拆分为两步：

-- 第一步：添加字段并明确指定字符集/校对规则
ALTER TABLE `connector`
    ADD COLUMN IF NOT EXISTS `preset_id` CHAR(36) CHARACTER SET 'utf8mb4' COLLATE 'utf8mb4_unicode_520_ci';

-- 第二步：创建外键约束
ALTER TABLE `connector`
    ADD CONSTRAINT `fk_connector_preset_id` FOREIGN KEY (`preset_id`) REFERENCES `connector_preset` (`id`);

2. 确保存储引擎一致且支持外键 #

外键仅InnoDB引擎支持，需确认两张表都使用InnoDB。修改表创建语句，显式指定存储引擎：

-- 修改connector_preset的创建语句
CREATE TABLE IF NOT EXISTS connector_preset
(
    id CHAR(36) NOT NULL,
    -- 其他字段省略
    PRIMARY KEY (id)
) ENGINE=InnoDB DEFAULT CHARACTER SET 'utf8mb4' COLLATE 'utf8mb4_unicode_520_ci';

3. 检查Flyway迁移执行顺序 #

全新环境（如Testcontainers、GitHub Actions）中，若创建外键的迁移版本早于connector_preset表的创建迁移，会因表不存在导致报错。确认迁移文件的版本号顺序，保证connector_preset表先被创建。

4. 移除ALTER IGNORE关键字 #

MariaDB 10.5+版本已废弃ALTER IGNORE，且该关键字无法忽略外键创建的结构性错误，移除后可得到更准确的错误提示，便于排查。

5. 验证字段属性完全匹配 #

即使表级字符集已统一，仍需确认字段级的字符集、校对规则完全一致：

-- 查看字段属性
SHOW FULL COLUMNS FROM connector_preset LIKE 'id';
SHOW FULL COLUMNS FROM connector LIKE 'preset_id';

确保两者的Collation完全相同（如均为utf8mb4_unicode_520_ci）。

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