Blazor 怎么使用 Entity Framework Core

Blazor Server 可安全使用 EF Core,但需避免共享 DbContext:用 OwningComponentBase 为组件创建独立作用域,或通过 IServiceScopeFactory 为写操作新建临时作用域;查询应封装为显式调用的异步方法并立即执行。

Blazor(尤其是 Server 端)能用 Entity Framework Core,但不能像传统 MVC 或 Razor Pages 那样“自然”地用——因为 Blazor 是有状态的、长连接的,而 EF Core 的 DbContext 默认是作用域(Scoped)服务,生命周期和 HTTP 请求强绑定。直接注入全局 DbContext 会导致数据污染、并发异常、重复查询等问题。关键不是“能不能用”,而是“怎么安全、高效、可维护地用”。

区分 Blazor 渲染模式再选方案

Server 端和 WebAssembly(WASM)完全不一样:

  • Blazor Server:可以直接用 EF Core 访问数据库(服务端执行),但必须严格管理 DbContext 生命周期;
  • Blazor WASM:运行在浏览器沙盒中,不能直连数据库,必须通过 Web API 中转,EF Core 只能放在后端 API 层。

本文默认讨论 Blazor Server 场景(也是 EF Core 集成最常见、最需注意的场景)。

避免共享 DbContext:用 OwningComponentBase

默认注入的 DbContext 在整个 SignalR 连接(即用户会话)中可能被多个组件复用,导致未提交的变更互相干扰。解决办法是让每个组件拥有自己的 DbContext 实例:

  • 继承 OwningComponentBase,组件初始化时自动创建专属作用域;
  • 组件销毁时,该作用域连带 DbContext 自动释放,无需手动调用 Dispose()
  • 代码示例:@inherits OwningComponentBase,然后在组件中通过 ObjectContext 属性访问上下文。

按操作新建 DbContext:推荐用于增删改

对“添加”“编辑”“删除”这类写操作,更稳妥的做法是不依赖组件级上下文,而是在每次操作时显式创建新实例:

  • 使用 IServiceScopeFactory 创建临时作用域:using var scope = scopeFactory.CreateScope();
  • 从中获取 DbContext,执行 SaveChanges,立即释放;
  • 这样彻底隔离操作,避免脏读、乐观并发冲突,也方便事务控制。

查询优化:别让渲染触发多次数据库请求

Blazor 组件频繁重渲染(比如响应输入、切换 Tab)时,若查询逻辑写在 @code 块里没加缓存或异步锁,可能反复执行相同 SQL:

  • 把查询封装为 async Task 方法(如 LoadDataAsync()),只在需要时主动调用;
  • .ToListAsync() 强制立即执行并缓存结果,不要留着 IQueryable 去“懒加载”;
  • 配合按钮触发更新(如 ),而不是靠 OnInitializedAsync 每次都查。

基本上就这些。核心就两点:组件间不共用 DbContext,写操作不跨作用域;查询不随渲染自动跑。做对了,EF Core 和 Blazor 就能稳稳配合。