外键约束生成DDL前必须确认引用表已存在，检查表、主键名、列名、类型一致性及权限，并注意MySQL与PostgreSQL在语法、锁机制和校验行为上的关键差异。
外键约束生成 DDL 前必须确认引用表已存在
生产环境加外键失败，八成是因为 alter table ... add constraint 语句里引用的主表或列根本不存在。不是“脚本写错了”，而是目标库比开发库少了一张表、或者字段名大小写不一致（尤其 postgresql）、甚至主键名被手动改过。
- 执行前用
SELECT table_name FROM information_schema.tables核对两张表是否都在目标库中 - 检查主表的主键定义：用
SELECT constraint_name, column_name FROM information_schema.key_column_usage WHERE table_name = 'xxx' AND constraint_name LIKE 'pk_%'确认实际主键名和列名 - MySQL 8.0+ 默认开启
sql_require_primary_key，但外键仍要求被引用列有显式 PRIMARY KEY 或 UNIQUE + NOT NULL，不能只靠索引
MySQL 和 PostgreSQL 的外键语法差异直接影响脚本可移植性
同一份建表语句，在 MySQL 跑得通，到 PostgreSQL 就报错 ERROR: there is no unique constraint matching given keys for referenced table，往往不是数据问题，是语法容忍度不同。
- MySQL 允许外键引用非主键的 UNIQUE 列；PostgreSQL 要求必须是 PRIMARY KEY 或明确带 UNIQUE 约束的列，且该约束不能含 NULL（即必须声明
NOT NULL） - PostgreSQL 外键定义中
ON DELETE CASCADE是默认不启用的，而 MySQL 默认允许——如果脚本里没写，MySQL 可能静默生效，PostgreSQL 直接忽略 - 避免用
CONSTRAINT fk_name FOREIGN KEY (col) REFERENCES other_table(col)省略类型匹配；务必确保col在两张表中类型完全一致（比如INTvsBIGINT、VARCHAR(255)vsTEXT都会失败）
线上执行外键 DDL 时锁表现差异极大
加外键不是纯元数据操作。MySQL 5.7+ 对大表会隐式加 MDL 锁并扫描全表校验数据一致性；PostgreSQL 则在 ADD CONSTRAINT 时对整张表加 ACCESS EXCLUSIVE 锁——意味着读写全阻塞。
- 别在高峰期跑
ALTER TABLE orders ADD CONSTRAINT fk_user_id FOREIGN KEY (user_id) REFERENCES users(id)，1000 万行订单表可能锁住 3 分钟以上 - MySQL 可先用
SELECT COUNT(*) FROM orders LEFT JOIN users ON orders.user_id = users.id WHERE users.id IS NULL手动验证参照完整性，再加约束（跳过自动校验） - PostgreSQL 8.2+ 支持
ADD CONSTRAINT ... NOT VALID，先建约束但不校验历史数据，之后用VALIDATE CONSTRAINT单独异步校验，减少锁时间
自动化生成 DDL 脚本容易漏掉依赖顺序和权限检查
用工具（如 Liquibase、flyway diff 或自写 Python 脚本）导出外键 DDL 时，常生成一堆孤立的 ALTER TABLE，但没考虑执行顺序——比如先给 orders 加外键指向 users，但 users 表还没创建。
- 生成脚本前必须做拓扑排序：所有被引用表必须出现在引用表之前；可用
pg_depend（PG）或INFORMATION_SCHEMA.KEY_COLUMN_USAGE（MySQL）提取依赖关系 - 生产账号往往只有
SELECT和INSERT，缺REFERENCES权限会导致外键创建失败，错误信息是ERROR: permission denied for relation users，不是语法问题 - 别信“开发环境能跑=生产能跑”——开发库可能关了
foreign_key_checks（MySQL）或session_replication_role = 'replica'（PG），掩盖了约束冲突
真正麻烦的从来不是写出那条 ADD CONSTRAINT，而是搞清它背后牵扯的表状态、权限链路、锁粒度和跨环境类型对齐。这些细节不提前卡死，上线那一刻才暴露，就只能回滚。
