数据库结构版本管理

Fri, 24 Jul 2026 10:00:00 +0800

为什么数据库也需要版本管理？

假设你开发新功能时，在本地执行了：

ALTER TABLE users ADD COLUMN nickname VARCHAR(100);

代码提交并部署到测试环境后，接口却报错：

column "nickname" does not exist

原因很简单：代码进入了 Git，修改数据库的 SQL 却只存在于你的电脑里。

如果数据库变更依靠聊天记录或人工执行，我们就很难回答：

解决办法是 DB Migration（数据库迁移）：把每次数据库结构变化写成带版本号的文件，提交到 Git，再由工具按顺序执行。

可以把 Migration 理解成“数据库的 Git Commit”：

20260724100000 创建 users 表
20260724103000 增加 nickname 字段
20260724110000 创建邮箱索引

迁移工具会：

几个容易混淆的概念：

Migration 不能代替备份。执行 DROP COLUMN 后，Down Migration 也不一定能找回已经删除的数据。

ORM 自动建表也不完全等于版本管理。ORM 可以帮助生成 Migration，但共享环境最好执行已经生成、评审并提交到 Git 的确定性 SQL，而不是在应用启动时临时修改数据库。