ASP.NET中结合WebSocket使用EF Core DbContext（长生命周期问题）

问题核心 #

WebSocket属于长连接，控制器实例在连接存续期间不会销毁。而默认的Scoped DbContext会与控制器生命周期绑定，导致同一个DbContext被用于多个跨工作单元的数据库操作，变更跟踪缓存的实体与数据库实际状态冲突，最终引发跟踪冲突错误。

推荐方案：使用DbContext工厂（官方最佳实践） #

.NET 6+中EF Core提供的IDbContextFactory<TContext>，专门针对长连接、后台任务这类无法依赖请求作用域的场景设计，是最简洁可靠的解决方案。

步骤1：注册DbContext工厂 #

在Program.cs中替换原有的Scoped DbContext注册逻辑，改为注册工厂：

builder.Services.AddDbContextFactory<YourDbContext>(options =>
    options.UseMySql(builder.Configuration.GetConnectionString("DefaultConnection"), 
        new MySqlServerVersion(new Version(8, 0, 28))));

步骤2：在WebSocket控制器中使用工厂 #

在控制器注入IDbContextFactory<YourDbContext>，每次执行数据库操作时创建新的DbContext实例，并用using确保资源及时释放：

public class WebSocketController : ControllerBase
{
    private readonly IDbContextFactory<YourDbContext> _dbContextFactory;

    public WebSocketController(IDbContextFactory<YourDbContext> dbContextFactory)
    {
        _dbContextFactory = dbContextFactory;
    }

    [HttpGet("/ws")]
    public async Task Get()
    {
        if (HttpContext.WebSockets.IsWebSocketRequest)
        {
            using var webSocket = await HttpContext.WebSockets.AcceptWebSocketAsync();
            var buffer = new byte[1024 * 4];
            WebSocketReceiveResult result;

            do
            {
                result = await webSocket.ReceiveAsync(new ArraySegment<byte>(buffer), CancellationToken.None);
                // 处理消息后执行独立的数据库操作
                await HandleDatabaseOperationAsync();

            } while (!result.CloseStatus.HasValue);

            await webSocket.CloseAsync(result.CloseStatus.Value, result.CloseStatusDescription, CancellationToken.None);
        }
        else
        {
            HttpContext.Response.StatusCode = StatusCodes.Status400BadRequest;
        }
    }

    private async Task HandleDatabaseOperationAsync()
    {
        // 每次操作创建全新的DbContext实例，保证工作单元独立
        using var context = _dbContextFactory.CreateDbContext();
        
        // 示例：添加实体操作
        var block = new Block 
        { 
            Blocksowner = Guid.Parse("3ae66710-5307-022f-2c31-5bcb1f468af2"), 
            Blockspartner = "SYSTEM" 
        };
        
        context.Blocks.Add(block);
        await context.SaveChangesAsync();
    }
}

其他方案的优劣对比 #

• Transient DbContext手动管理：可行但繁琐，需手动编写using逻辑，容易遗漏导致资源泄漏，不如工厂模式简洁。
• 保持Scoped DbContext：不可行，WebSocket连接不属于单一请求作用域，长期持有Scoped实例会引发跟踪冲突和内存泄漏。
• 每次操作后清除跟踪实体：不推荐，context.ChangeTracker.Clear()会清除所有跟踪状态，可能干扰未完成的操作，无法从根源解决多工作单元复用DbContext的问题。

关键注意事项 #

• 每次数据库操作必须创建新的DbContext实例，确保每个工作单元完全独立。
• 始终用using包裹DbContext实例，操作完成后及时释放资源，避免数据库连接池耗尽。

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