EF Core 的 DbContext 须继承自定义类并通过依赖注入创建,需在 Program.cs 中注册并配置数据库提供者;DbSet 是 IQueryable,查询需可翻译为 SQL;SaveChangesAsync 应用于 Web 异步场景;迁移命令需正确指定项目路径。

EF Core 的 DbContext 是怎么被创建和使用的
EF Core 不是靠静态方法调用的,核心入口是继承 DbContext 的自定义类。你得先定义它,再通过依赖注入或手动 new(不推荐)来获取实例。没这个上下文,DbSet 就只是个空壳。
常见错误:直接 new 一个 DbContext 而没配置连接字符串或服务提供者,运行时抛 InvalidOperationException: No database provider has been configured。
- 必须在
Program.cs(.NET 6+)中调用services.AddDbContext,并传入连接字符串和数据库提供者(如() Microsoft.EntityFrameworkCore.SqlServer) -
AppDbContext构造函数应接受DbContextOptions并传给基类,不能漏掉: base(options) - 每个 HTTP 请求建议只用一个
DbContext实例(Scoped 生命周期),重复 new 或长期持有会导致追踪混乱和内存泄漏
DbSet 查询为什么有时不走 SQL,有时又报“无法翻译”
DbSet 表面像集合,实际是 IQueryable —— 它延迟执行,且 EF 会尝试把 C# 表达式树翻译成 SQL。但不是所有操作都能翻译,尤其涉及本地方法、复杂对象构造或未映射属性时。
典型现象:Where(x => x.Name.ToUpper() == "ADMIN") 在 SQLite 下可能成功,但在 SQL Server 上触发客户端评估警告;而 Where(x => MyHelper.IsSpecial(x.Id)) 直接报错 System.InvalidOperationException: The LINQ expression could not be translated。
- 优先用 EF 支持的表达式:比如
string.Equals(a, b, StringComparison.OrdinalIgnoreCase)比a.ToLower() == b.ToLower()更易翻译 - 避免在查询中调用自定义方法、
new对象(除非是匿名类型或实体映射字段)、DateTime.Now(改用DateTime.UtcNow,EF 能识别) - 不确定是否可翻译?加
.AsEnumerable()强制转为客户端执行(但会拉全表!仅调试用)
SaveChanges 和 SaveChangesAsync 的区别不只是同步异步
SaveChanges() 是同步阻塞调用,会等数据库事务提交完成才返回;SaveChangesAsync() 是真正的异步,底层使用数据库驱动的 async I/O,不占用线程池线程。
ShopNC多用户商城,全新的框架体系,呈现给您不同于以往的操作模式,更简约的界面,更流畅的搜索机制,更具人性化的管理后台操作,更适应现在网络的运营模式解决方案,为您的创业之路打下了坚实的基础,你们的需求就是我们的动力。我们在原有的C-C模式的基础上更增添了时下最流行的团购频道,进一步的为您提高用户的活跃度以及黏性提供帮助。ShopNC商城系统V2.4版本新增功能及修改功能如下:微商城频道A、商城
容易踩的坑:在 ASP.NET Core 控制器里用了 SaveChanges() 却声明了 async Task 方法,结果既没真正异步,又因未 await 导致状态机混乱或静默失败。
- Web 应用一律用
await context.SaveChangesAsync(),不要混用同步方法 - 事务控制要显式:用
await context.Database.BeginTransactionAsync(),而不是靠SaveChanges自动开启(它只在无事务时新建) - 批量插入大量数据?别循环调
Add()+SaveChanges()—— 每次都开事务。改用context.AddRange()一次添加多个,再单次SaveChanges
迁移(Migration)命令为什么总提示“无法访问项目”或“No migrations found”
EF Core 迁移命令(如 dotnet ef migrations add Init)需要同时知道两个东西:实体模型在哪(--project)、DbContext 类型在哪(--startup-project)。多数失败是因为路径或程序集解析错了。
典型报错:Unable to retrieve project metadata. Ensure it's an SDK-style project 或 No DbContext was found。
- 确保当前终端目录是含
.csproj的项目根目录;如果 DbContext 在类库,需用--project指向该类库,--startup-project指向 Web/Console 主项目 - 主项目必须引用 EF Core 设计时包:
Microsoft.EntityFrameworkCore.Design(开发时必需,非运行时) - 迁移文件生成后,
dotnet ef database update才真正建表;别以为migrations add就完事了
dotnet ef migrations add Init --project .\MyData.dll --startup-project .\MyWebApp.csproj
EF Core 的麻烦点不在语法多难,而在它横跨了对象模型、SQL 生成、生命周期管理和工具链四层。任何一个环节断开(比如 DbContext 注册漏了、迁移没指定 startup-project、查询用了不可翻译方法),都会表现为“不工作”,但错误信息往往藏在不同位置。动手前先确认这四层是否都连上了。









