MySQL 外键迁移的检查开关与恢复顺序

导入有外键关系的表时，真正需要控制的是当前迁移连接，而不是把整个 MySQL 实例的约束检查随手关掉。实用做法是保存 @@SESSION.foreign_key_checks 的原值，在同一个会话内临时关闭，完成导入后恢复原值，再单独检查是否产生孤儿数据。

官方地址：https://dev.mysql.com/doc/refman/8.4/en/create-table-foreign-keys.html

MySQL 外键迁移先区分会话开关与完整性检查

foreign_key_checks 是动态变量，默认开启，并支持会话级和全局级作用域。迁移脚本通常只需要解决“父表和子表导入顺序不一致”这个局部问题，因此应使用 SET SESSION。SET GLOBAL 会把新连接的默认行为也带入风险范围，生产环境不适合作为临时开关。

导入结束后同时检查开关状态与孤儿数据

下面的示例把原值保存到用户变量，便于迁移失败或脚本提前退出时恢复。SOURCE 只是示例导入动作，实际项目也可以替换为应用迁移工具。

-- 保存当前会话原值，避免结束时强行猜测应该恢复成什么
SET @old_fk_checks := @@SESSION.foreign_key_checks;

-- 只关闭当前迁移连接的外键检查，不改变其他连接
SET SESSION foreign_key_checks = 0;

-- 示例：这里执行建表、装载数据或迁移工具生成的 SQL
SOURCE /data/migrate/orders.sql;

-- 无论导入是否跨过父子表顺序，都要在收尾处恢复原值
SET SESSION foreign_key_checks = @old_fk_checks;

这个开关适合解决导入顺序问题，不适合掩盖错误数据。尤其要注意：重新设为 1 后，不应把它理解成 MySQL 已经替你回扫了此前导入的每一行；数据检查必须由迁移流程显式完成。

把“开关恢复”和“关系完整”拆成两组验证

先检查当前连接的变量值，再查询子表中找不到父表的记录。下面的查询只展示前 20 条，便于在大表上先观察结果；生产核对还应结合业务主键、批次号或校验计数。

-- 先确认当前连接已恢复到预期值；结果为 1 才表示检查已打开
SELECT @@SESSION.foreign_key_checks AS session_fk_checks;

-- 查找子表有外键值、但父表不存在的孤儿记录
SELECT c.id, c.parent_id
FROM child_table AS c
LEFT JOIN parent_table AS p ON p.id = c.parent_id
WHERE c.parent_id IS NOT NULL
  AND p.id IS NULL
LIMIT 20;

如果第一条结果正确、第二条仍返回记录，结论只能是“开关恢复了，但数据不完整”。这时应根据迁移批次回滚或补齐父表，不要再次关闭检查来掩盖结果。

迁移失败时的处理清单与边界

连接断开、导入脚本中途报错、误用了 GLOBAL，都应按异常路径处理：确认旧连接是否还存在，重新建立连接后检查会话变量；对已经写入的表记录批次，再决定回滚或修复；若使用了全局设置，立即恢复并检查后续新连接的默认值。

此外，MySQL 的外键约束依赖支持它的存储引擎和正确的约束定义。迁移前应确认父键、子键类型与索引关系，不能只依赖 foreign_key_checks 这个开关。最后保留变量检查、孤儿查询和关键业务抽样三份结果，后续排查会比只看“导入成功”可靠。

常见问题

为什么不建议用 SET GLOBAL foreign_key_checks = 0？

它的影响范围更大，容易让其他连接在不知情的情况下写入未受约束的数据。一次性导入优先使用当前会话。

恢复为 1 后还需要查孤儿记录吗？

需要。变量恢复与历史数据完整性是两件事，前者不能替代后者。

导入脚本失败后可以直接再次执行吗？

不要直接重跑。先确认已执行到哪个批次、哪些表已经写入，并清理或回滚半成品，再按同一套开关和核对清单继续。