在db_schema.xml新增外键后setup:upgrade失败，通常是旧表已有孤儿数据或两列类型并不完全一致。

固定复现范围

用LEFT JOIN找出子表中不存在父记录的值，并统计数量；不要先关闭foreign_key_checks强行建约束。

定位真实原因

比较两列数据类型、unsigned、长度与字符集，引用列必须有索引且定义兼容。

执行修复

制定孤儿数据处理规则：补父记录、归档或删除，并先在数据库副本验证影响。

恢复后处理

修正数据和Schema后运行setup:upgrade，再检查SHOW CREATE TABLE和级联删除策略是否符合业务。

SELECT c.parent_id,COUNT(*) FROM child_table c LEFT JOIN parent_table p ON p.entity_id=c.parent_id WHERE p.entity_id IS NULL GROUP BY c.parent_id;SHOW CREATE TABLE child_table;SHOW CREATE TABLE parent_table;bin/magento setup:upgrade

回归测试

升级成功且重复执行无变化，新增非法parent_id被数据库拒绝，删除父记录按预期RESTRICT或CASCADE。