讲师中心 微信公众号
AI工具推荐 视频效率加速

C# 实体框架数据库迁移方法 C# EF Core如何进行数据库迁移

浅辰君_1528

浅辰君_1528

发布时间:2026-01-29 09:50:02

|

275人浏览过

|

来源于php中文网

原创

EF Core迁移需在DbContext项目目录执行,安装Microsoft.EntityFrameworkCore.Tools;Add-Migration生成迁移文件,Update-Database同步数据库,Remove-Migration撤回上一次迁移,Script-Migration生成SQL脚本供生产部署。

c# 实体框架数据库迁移方法 c# ef core如何进行数据库迁移

EF Core 迁移命令在 Package Manager Console 中怎么写

迁移必须在包含 DbContext 的项目目录下执行,且项目需安装 Microsoft.EntityFrameworkCore.Tools。常见错误是直接在解决方案根目录运行,导致提示“找不到 DbContext 类型”或“无法解析 DbContext”。

  • Add-Migration InitialCreate:生成首次迁移文件(含 Up/Down 方法),文件名可自定义,但建议语义化
  • Update-Database:将待应用的迁移同步到数据库;若指定名称(如 Update-Database InitialCreate),则只执行到该迁移
  • Remove-Migration:撤回最后一次 Add-Migration 生成的文件(不触碰数据库),适合改错后重来

注意:Update-Database 默认连接字符串来自 Startup.cs 或 Program.cs 中的 UseSqlServer 配置,不是 appsettings.json 的默认节——除非你显式传入 -ConnectionString 参数。

使用 dotnet CLI 执行迁移时为什么报错“Unable to create an object of type 'AppDbContext'”

这是最常遇到的启动失败错误,本质是 EF Core 运行时无法构造你的 DbContext。根本原因通常是依赖注入链断裂,比如:

  • AppDbContext 构造函数依赖了未注册的服务(如 IConfiguration 或自定义仓储接口)
  • 项目中存在多个 DbContext,但没用 [DbContextOptions<t>]</t> 明确指定目标类型
  • 缺少无参构造函数,且 OnConfiguring 未被重写(CLI 不走 Startup 的 DI 容器)

解决方法:在 AppDbContext 中补充一个仅用于迁移的构造函数,例如:

public AppDbContext(DbContextOptions<AppDbContext> options) : base(options) { }
public AppDbContext() : base(new DbContextOptionsBuilder<AppDbContext>()
    .UseSqlServer("Server=.;Database=TestDb;Trusted_Connection=true;")
    .Options) { }

或者更稳妥的方式:确保 dotnet ef migrations add 命令能识别你的启动项目和上下文类型,加 --project 和 --startup-project 参数。

arcgis-js
arcgis-js

提供 ArcGIS Maps SDK for JavaScript 开发辅助,涵盖 2D/3D 地图视图、图层管理、数据可视化、空间分析等功能模块的参考和示例指导。

下载

迁移文件里生成的 SQL 为什么和预期不符?比如字段没加索引或约束丢失

EF Core 的迁移基于模型快照(ModelSnapshot)与当前 DbContext 模型对比生成,不是实时读取数据库结构。所以以下情况会导致 SQL 异常:

  • 手动修改过迁移文件中的 Up 方法,后续再 Add-Migration 会基于修改后的版本继续推导,产生偏差
  • 实体类上用了 [Column(TypeName = "datetime2")] 等特性,但忘了在 OnModelCreating 中配置对应索引或约束
  • 使用了 HasIndex(e => e.Status).IsUnique() 却没调用 HasDatabaseName("IX_Orders_Status"),导致迁移名随机,难以追踪

建议始终用 Fluent API 在 OnModelCreating 中集中声明约束,避免混用 Data Annotations 和 Fluent 风格;迁移生成后,打开 Up(MigrationBuilder migrationBuilder) 方法检查 SQL 是否含 CREATE INDEX 或 ADD CONSTRAINT,别盲目 Update-Database。

生产环境部署迁移时如何避免直接执行 Update-Database

线上库不允许开发机直连,也不能依赖 PowerShell 环境。正确做法是把迁移编译成 SQL 脚本,交由 DBA 审核执行:

  • Script-Migration(PMC)或 dotnet ef migrations script(CLI)生成完整脚本,默认从初始迁移到最新
  • 加 -From 和 -To 参数可限定范围,例如只导出 v1.2 到 v1.3 的变更
  • 脚本不含 IF NOT EXISTS 判断,执行前需确认目标库状态;若要幂等,得自己加包装逻辑或用 --idempotent 参数(仅限 SQL Server)

特别注意:脚本不会执行 Seed 数据(即 HasData),这部分仍需代码控制,或拆成独立部署步骤。

热门AI工具

更多
Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

4643

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

951

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

1229

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

6641

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

3383

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

6620

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

9101

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

1230

2024.04.29

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

60

2026.10.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 21.3万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn