EF Core 更新数据库需先执行 Add-Migration 生成迁移文件,再运行 Update-Database 应用迁移;直接 Update-Database 无效。迁移名可自定义,支持更新至指定迁移、回退或重置(Update-Database 0)。

EF Core 更新数据库主要靠 Update-Database 命令,但它不是“一键同步代码到库”,而是执行已存在的迁移(Migration)来变更数据库结构或数据。关键前提是:你得先有迁移文件。
先确保已有迁移文件
修改了实体类或 DbContext 后,不能直接 Update-Database,必须先生成迁移:
- 在包管理器控制台(PMC)运行:Add-Migration InitDb(InitDb 是迁移名,可自定义)
- 或使用 .NET CLI:dotnet ef migrations add InitDb
- 命令会生成一个带时间戳的迁移类(如
20241105082345_InitDb.cs)和快照文件 - 检查生成的
Up(MigrationBuilder migrationBuilder)方法,确认 SQL 操作符合预期(比如加字段、改类型等)
执行更新到最新迁移
生成迁移后,再运行更新命令:
- PMC:Update-Database(默认应用所有未执行的迁移)
- .NET CLI:dotnet ef database update
- 它会读取
_EFMigrationsHistory表,只执行尚未应用的迁移 - 成功后,数据库结构就和当前迁移一致了
指定更新到某一个迁移
有时需要回退或只更新到某个中间版本:
- 更新到指定迁移(含该迁移):Update-Database InitDb(用迁移类名或时间戳前缀)
- 回退到上一个迁移:Update-Database PreviousMigrationName
- 完全清空迁移历史(慎用):Update-Database 0,相当于重置数据库(会删表)
常见问题提醒
Update-Database 失败?多半是这几个原因:
- 项目未设为启动项目,或未选中含 DbContext 的项目作为“默认项目”(PMC 中要选对)
- 连接字符串配置错误,或数据库不可达(检查 appsettings.json 或环境变量)
- 迁移中有不支持的自动操作(如删非空列),需手动编辑
Up方法加逻辑或默认值 - 多个上下文共存时,需用 -Context MyDbContext 显式指定
基本上就这些。记住核心流程:改模型 → Add-Migration → Update-Database。不复杂但容易忽略迁移这一步。










