如何在Server-Side Blazor组件中访问Entity Framework DbContext实体

作为从WebForms和MVC转过来的开发者，你完全可以在Server-Side Blazor组件里直接使用Entity Framework Core的DbContext，而且方式和你熟悉的MVC控制器用法非常接近——不过有几个关键细节要注意，因为Blazor组件的生命周期和MVC请求模型不一样。

方式一：直接注入DbContext（简单场景适用） #

首先，在应用启动配置（.NET 6+是Program.cs，旧版本是Startup.cs）里注册你的DbContext，和MVC里的做法一致：

builder.Services.AddDbContext<ApplicationDbContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));

然后在.razor组件里通过@inject指令注入DbContext，就能像在MVC控制器里一样直接查询数据了：

@inject ApplicationDbContext Context
@using YourProject.Models

<h3>Things List</h3>

@if (things == null)
{
    <p><em>Loading...</em></p>
}
else
{
    <ul>
        @foreach (var thing in things)
        {
            <li>@thing.Name</li>
        }
    </ul>
}

@code {
    private List<Thing> things;

    protected override async Task OnInitializedAsync()
    {
        // 和你在MVC里写的查询几乎一模一样
        things = await Context.Things.Where(t => t.ThingAttributes == "something").ToListAsync();
    }
}

这种方式最贴合你熟悉的用法，但要注意：Server-Side Blazor中，Scoped服务（包括DbContext）的生命周期和用户的SignalR连接绑定，而非单个HTTP请求。如果你的组件会长期存在（比如一直打开的仪表盘页面），DbContext可能会持有数据库连接太久，这时更推荐下面的方式。

方式二：使用IDbContextFactory（长期组件场景更安全） #

为了避免DbContext长期占用连接的问题，EF Core提供了IDbContextFactory，可以按需创建短期的DbContext实例，用完自动释放：

首先在启动配置里注册工厂：

builder.Services.AddDbContextFactory<ApplicationDbContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));

然后在组件里注入工厂，创建并使用DbContext：

@inject IDbContextFactory<ApplicationDbContext> DbContextFactory
@using YourProject.Models

<!-- UI部分和上面一致 -->

@code {
    private List<Thing> things;

    protected override async Task OnInitializedAsync()
    {
        using var context = DbContextFactory.CreateDbContext();
        things = await context.Things.Where(t => t.ThingAttributes == "something").ToListAsync();
    }
}

using语句会自动释放DbContext，避免资源泄漏，这种方式更适合生命周期较长的组件。

进阶：封装数据访问到服务层（大型项目推荐） #

虽然可以直接在组件里用DbContext，但和MVC的最佳实践一样，Blazor里也建议把数据访问逻辑封装到服务层——这样组件只负责UI渲染，数据逻辑集中管理，更利于测试和维护：

1. 创建数据服务类：

public class ThingService
{
    private readonly ApplicationDbContext _context;

    public ThingService(ApplicationDbContext context)
    {
        _context = context;
    }

    public async Task<List<Thing>> GetThingsByAttribute(string attributeValue)
    {
        return await _context.Things.Where(t => t.ThingAttributes == attributeValue).ToListAsync();
    }

    // 可添加新增、修改、删除等业务方法
}

2. 在启动配置里注册服务：

builder.Services.AddScoped<ThingService>();

3. 在组件里注入服务并使用：

@inject ThingService ThingService

<!-- UI部分 -->

@code {
    private List<Thing> things;

    protected override async Task OnInitializedAsync()
    {
        things = await ThingService.GetThingsByAttribute("something");
    }
}

关键注意事项 #

• 不要在组件构造函数里使用DbContext或数据服务：Blazor的依赖注入在构造函数阶段可能未完全就绪，应该在OnInitializedAsync或OnAfterRenderAsync这类生命周期方法里操作数据。
• DbContext不是线程安全的：不要在多线程场景下复用同一个DbContext实例，用IDbContextFactory创建短期实例或在服务层使用Scoped DbContext（每个用户连接对应一个Scope，线程安全）。
• 数据更新后要通知UI：如果在组件里修改了数据（比如新增一条记录），记得调用StateHasChanged()方法触发组件重新渲染。

推荐阅读内容 #

官方文档里的「Entity Framework Core in Blazor apps」章节详细讲解了Blazor中EF Core的最佳实践，「ASP.NET Core Blazor data binding」部分可以帮你理解组件数据更新的逻辑；社区关于Blazor服务层设计的讨论也能帮你更好地组织代码。

内容的提问来源于stack exchange，提问作者Josh Bula