一个在有人忘了写数据库迁移时让构建失败的 CI 检查

在一家中型 SaaS 公司,有个反复出现的烦心事:有人在 PR 里改了数据库模型,却忘了把迁移文件一起带上,合并之后 staging 就崩了。这事发生得太频繁,以至于都有了个外号。作为实习生,我问能不能让我试着在 CI 里把它抓出来。我最初的想法很天真——就检查一下:只要有模型文件改动了,就得有个迁移文件也跟着改。但这会误报,比如改个注释、编辑一下 docstring,本不该要求迁移。所以我转而依赖 ORM 自带的工具:我加了个 CI 步骤,在一个用完即弃的数据库里跑框架自带的『检查是否缺失迁移』命令,如果它报出有待处理的 schema 变更却没有对应迁移,就让构建失败。这么做是权威的,因为它是去问框架本身,而不是从文件 diff 里瞎猜。难点在于把失败提示做得有用——一个红叉配上啥解释都没有,只会惹人烦——所以我让它把生成缺失迁移的那条确切命令直接打印出来。我特意开了个『改了模型但没带迁移』的 PR 来测试,确认它会变红;又开了个两样都带上的,确认它保持绿色。它把我们团队里『忘写迁移』导致的崩溃基本降到了零。