EF Core怎么更新数据库 EF Core更新数据库(Update-Database)教程

来源:这里教程网 时间:2026-02-21 17:34:37 作者:

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。不复杂但容易忽略迁移这一步。

相关推荐