Npgsql连接池耗尽问题：释放DbContext后连接未归还求助

阿华AIGC实验室

2026-5-20

解决Npgsql连接池耗尽：DbContext释放后连接未归还的问题

我之前也踩过一模一样的坑——一开始急着用SemaphoreSlim来限制并发请求，以为能解决Npgsql连接池耗尽的问题，但折腾了好一阵才发现，核心问题根本不是并发数太高，而是DbContext被释放后，数据库连接压根没回到连接池里。更让人困惑的是，我所有数据库操作都严格套在using语句里，按道理应该自动释放资源才对。

先贴一下当时类似的代码场景（和你给出的示例一致）：

using (var context = ContextFactory.GetContext<PostgreSqlDatabaseContext>(connectionString)) 
{ 
    var query = $"SELECT * FROM public.\"MyTable\" WHERE \"MyId\" = '{id}'"; 
    var result = await context.MyTable.FromSqlRaw(query).FirstOrDefaultAsync();
    // 其他数据库操作逻辑
}

可能的原因排查方向

从我的经验来看，这种情况大概率不是using语句的问题，而是以下几个隐藏的细节没处理好：

ContextFactory的实现有问题：如果你的工厂方法返回的不是全新的DbContext实例（比如用了单例、静态缓存），或者DbContextOptions配置错误，会导致连接被长期持有。比如有些开发者图方便把DbContext做成静态的，这直接就破坏了using的生命周期管理。
存在未await的异步操作：如果在using块里启动了一个没有await的异步任务，这个后台任务会一直持有DbContext的引用，导致连接无法及时归还到池里。
连接字符串配置异常：虽然Npgsql默认开启连接池，但如果你的连接字符串里写了Pooling=false，或者MaxPoolSize设得太小，再或者开启了分布式事务（Enlist=true但没正确处理），都会导致连接无法正常回收。
手动操作连接未关闭：如果代码里手动调用了context.Database.OpenConnection()，但没在using块内显式关闭，哪怕DbContext被释放，连接也可能被卡住。

对应的解决步骤

修正ContextFactory的实现：确保每次调用GetContext都返回全新的DbContext实例，并且正确配置DbContextOptions：

public static TContext GetContext<TContext>(string connectionString) where TContext : DbContext
{
    var optionsBuilder = new DbContextOptionsBuilder<TContext>();
    optionsBuilder.UseNpgsql(connectionString);
    // 如果需要额外配置连接池参数，比如调整最大连接数
    // optionsBuilder.UseNpgsql(connectionString, o => o.MaxPoolSize(150));
    
    return (TContext)Activator.CreateInstance(typeof(TContext), optionsBuilder.Options);
}

排查异步操作：检查using块内的所有异步代码，确保全部都用await等待完成，绝对不能有“启动任务就不管”的情况。
校验连接字符串：确认连接字符串包含Pooling=true（默认开启，但最好显式写上），并且MaxPoolSize设置符合你的并发需求（默认100，可根据服务器配置调整）。

手动操作连接的正确姿势：如果必须手动打开连接，一定要在try/finally里显式关闭：

using (var context = ContextFactory.GetContext<PostgreSqlDatabaseContext>(connectionString))
{
    await context.Database.OpenConnectionAsync();
    try
    {
        // 执行需要直接操作连接的逻辑
    }
    finally
    {
        await context.Database.CloseConnectionAsync();
    }
}

启用日志排查：打开Npgsql的日志功能，跟踪连接的获取和释放过程，能精准定位到哪个环节没归还连接。比如添加控制台日志：
```
NpgsqlLogManager.Provider = new ConsoleLoggingProvider(NpgsqlLogLevel.Debug);
```