技术积累 · 数据库

放弃 EF 迁移,改用启动建表 SQL

EF 迁移本身是好机制。但在"多架构(schema)+ 受限数据库账号 + 服务器部署"的组合下,它引入了一个隐蔽的失败点。最终我把建表改成启动时执行幂等 SQL,反而睡得更安稳。

问题出在迁移历史表的位置

EF 迁移依赖一张历史表来记录"哪些迁移已经应用过"。这张表默认建在 public 架构——而我的数据库账号对 public 架构没有建表权限。结果:应用在服务器上启动即抛异常,数据库里一张业务表都没有,报错却指向一段完全无关的 SQL。

更隐蔽的是"半成品"形态:历史记录写入成功、建表语句执行失败,之后每次启动都认为"迁移已完成",直接跳过建表,直到业务 SQL 引用缺失的表才把真正的错误暴露出来。

幂等建表 SQL 的做法

改用启动时执行一段幂等 DDL:每张表、每个索引、每条约束都带 IF NOT EXISTS;主键这类无法用 IF NOT EXISTS 的,放进 DO 块里先查系统目录再加。执行两遍和执行一遍结果完全一致。

配套的原则是:表结构变更仍然用 EF 迁移生成,但只把生成的 DDL 抄进启动脚本,不在运行时执行 Migrate。这样既保留迁移的"改表不丢数据"能力,又把启动时的失败点收敛到一段可以反复重跑的 SQL。

一句话总结:部署环境不受控时,把"记录状态"换成"幂等重放"——让系统对半成品状态自带修复能力。