ASP.NET Web API中DbContext过早释放问题及方案抉择

问题背景 #

在ASP.NET Web API项目的Pay端点中，会调用应用层的DiscountService（包含5个方法），DiscountService中注入了PayLoggerService，并在4个不同位置调用其LogMessage()方法。

单次请求的方法执行序列：

Pay() 
    -> DiscountService -> DiscountService.A() 
       -> PayLoggerService.LogMessage() 
       -> DiscountService.B() -> PayLoggerService.LogMessage()

问题描述 #

每次调用LogMessage()后执行SaveChangesAsync()时，DbContext会被过早释放，报错信息如下：

Cannot access a disposed context instance. A common cause of this error is disposing a context instance that was resolved from dependency injection and then later trying to use the same context instance elsewhere in your application. This may occur if you are calling 'Dispose' on the context instance, or wrapping it in a using statement. If you are using dependency injection, you should let the dependency injection container take care of disposing context instances

错误发生在DiscountService.A()调用LogMessage()之后，因为LogMessage()末尾会调用SaveChangesAsync()，相关代码如下：

DiscountService代码 #

public class DiscountService
{
    private readonly PayLoggerService _payLoggerService;

    public DiscountService(PayLoggerService payLoggerService)
    {
        _payLoggerService = payLoggerService;
    }

    // 非异步方法，现有引用太多暂时无法改为异步
    public string A()
    {
        // 业务逻辑
        _payLoggerService.LogMessage(message).ConfigureAwait(false);
    }

    // 如果A()中调用的LogMessage执行SaveChangesAsync()出错，此方法不会被执行
    public string B()
    {
        // 业务逻辑
        _payLoggerService.LogMessage(message).ConfigureAwait(false);
    }
}

PayLoggerService代码 #

public class PayLoggerService : GeneralService
{
    public PayLoggerService(PayingContext dbContext) : base(dbContext)
    {
    }

    public async Task LogMessage(string message)
    {
        // 无关代码省略

        var bettingHistory = new BettingHistory
                                 {
                                     // 无关代码省略
                                 };

        // DbScope是GeneralService中定义的PayingContext实例
        await DbScope.PayLogs.AddAsync(bettingHistory);
        await DbScope.SaveChangesAsync(); // 此行触发错误
    }
}

已想到的可行方案 #

• 实现工作单元模式，在Pay()端点统一调用SaveChanges
• 实现DbContextFactory，每次需要时创建新的DbContext实例

请问有没有更优的处理方式？

解答 #

核心问题分析 #

错误根源在于同步方法中异步调用未等待：DiscountService的A()和B()是同步方法，但调用LogMessage()时仅用了.ConfigureAwait(false)却没有await，导致异步操作在后台执行时，当前请求的DbContext（默认请求级作用域）可能已经被DI容器释放，进而引发SaveChangesAsync()时的上下文已释放错误。

优先推荐的修复方案 #

1. 修正异步调用的等待逻辑（最小改动）

即使DiscountService的方法暂时无法改为异步，也需要确保异步的LogMessage()调用被正确等待，避免上下文提前释放：

// 修改DiscountService的A()和B()方法
public string A()
{
    // 业务逻辑
    // 使用GetAwaiter().GetResult()同步等待异步操作完成
    _payLoggerService.LogMessage(message).ConfigureAwait(false).GetAwaiter().GetResult();
}

public string B()
{
    // 业务逻辑
    _payLoggerService.LogMessage(message).ConfigureAwait(false).GetAwaiter().GetResult();
}

注意：这种方式会阻塞当前线程，但能保证异步日志操作完成后再继续执行后续逻辑，避免上下文释放问题。如果性能要求较高，后续仍建议逐步将上层方法改为异步。

2. 为日志服务配置独立的DbContext作用域

如果希望日志操作不依赖请求级上下文，可以在注册PayLoggerService时，为其注入的DbContext设置**瞬态（Transient）**生命周期，或者使用DbContextFactory每次创建新实例：

// 在Startup/Program.cs中注册服务
builder.Services.AddTransient<PayingContext>();
builder.Services.AddScoped<PayLoggerService>();

或者使用DbContextFactory：

public class PayLoggerService : GeneralService
{
    private readonly IDbContextFactory<PayingContext> _contextFactory;

    public PayLoggerService(IDbContextFactory<PayingContext> contextFactory)
    {
        _contextFactory = contextFactory;
    }

    public async Task LogMessage(string message)
    {
        using var dbContext = _contextFactory.CreateDbContext();
        var bettingHistory = new BettingHistory();
        await dbContext.PayLogs.AddAsync(bettingHistory);
        await dbContext.SaveChangesAsync();
    }
}

这种方式让日志操作拥有独立的上下文生命周期，不受请求上下文释放的影响，适合日志这类不需要和业务上下文共享状态的场景。

3. 工作单元模式（适合业务逻辑需要事务一致性的场景）

如果业务逻辑和日志操作需要在同一个事务中完成，工作单元模式是合适的选择：统一由工作单元管理DbContext，在Pay端点最后统一调用SaveChanges，确保所有操作完成后再提交并释放上下文。但这种方式需要调整现有服务的依赖注入逻辑，将DbContext替换为工作单元实例。

方案对比 #

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