ASP.NET Core API迁移至Postgres后EF Core与Npgsql连接池耗尽问题排查

结合你的场景，连接池耗尽的核心原因通常是数据库连接未被及时释放回池，以下是针对性的排查点：

• 集成测试的Scope管理问题
  集成测试中，如果测试框架未正确处理Scoped服务的生命周期，会导致Scoped的DbContext无法被回收，对应的数据库连接也不会归还到连接池。检查测试代码中是否存在：

  • 手动获取IContext后未通过Scope释放
  • 测试类中持有IContext的静态实例
  • 测试框架（如xUnit）的集合/类级Fixture中错误注入了Scoped服务

• EF Core上下文配置的潜在问题
  你通过OnConfiguring方法动态配置数据库，需确认：

  • 是否在OnConfiguring中存在重复创建连接相关资源的逻辑？正确的做法是直接调用optionsBuilder.UseNpgsql(connectionString)，额外的自定义配置可能干扰连接池管理
  • 是否重写了DbContext.Dispose方法但未调用基类Dispose？基类方法负责释放底层数据库连接，若被覆盖且未调用，会造成连接泄漏

• 未正确处理异步操作或事务

  • 检查所有数据操作代码，是否存在未await的异步方法？比如调用_context.Entities.FirstAsync()但未加await，会导致连接被异步操作持续持有
  • 事务未正确提交或回滚：若代码中开启了事务（如_context.Database.BeginTransaction()），但测试结束前未调用CommitAsync或RollbackAsync，连接会被事务锁定无法归还

• Npgsql与EF Core版本兼容性
  EF Core 5.1需要搭配Npgsql.EntityFrameworkCore.PostgreSQL 5.x版本使用，若安装的是更高版本（如6.x/7.x），可能存在兼容性问题导致连接池管理异常。确认NuGet包版本是否匹配：

  <PackageReference Include="Npgsql.EntityFrameworkCore.PostgreSQL" Version="5.0.17" />
  

• 测试并行执行的影响
  默认情况下xUnit等测试框架会并行执行用例，若每个测试至少占用一个连接，20个并行测试可能瞬间占满连接池（即使MaxPoolSize设为100，若单个测试占用多个连接也会耗尽）。可临时禁用测试并行验证：

  • 在测试项目中添加xunit.runner.json文件，设置"parallelizeTestCollections": false
  • 观察是否仍出现连接池耗尽问题，以此判断是否由并行执行导致

• 连接字符串的隐藏配置
  除Maximum Pool Size和Pooling外，以下参数也可能影响连接池：

  • Enlist：默认true，若测试中使用分布式事务，可能导致连接被绑定；可尝试添加Enlist=false测试
  • Command Timeout：若测试中有长时间运行的查询，会占用连接更长时间，导致池内可用连接不足

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