EntityFramework.Docs：Azure CosmosDB连接泄漏问题分析与解决方案

问题现象

在使用Entity Framework Core与Azure CosmosDB提供程序时，开发者遇到了一个严重的连接泄漏问题。具体表现为：每次应用服务重启后，到CosmosDB主机(cosmos-db-host:443)的出站TCP套接字连接数会从0开始持续增长，最终达到应用服务计划的连接数上限(如P3V3实例约8000个连接)。

当连接数接近上限时，服务响应时间会急剧上升，甚至简单的Swagger页面刷新都需要1-2分钟才能完成。这种问题迫使运维人员不得不定期重启服务以缓解性能问题。

技术背景

在正常情况下，EF Core的CosmosDB提供程序应该使用单例模式的Cosmos客户端，并通过连接池管理连接数。开发者通过依赖注入访问DbContext，理论上连接应该会被自动释放或保持在合理的连接池限制内。

问题根源

这个问题实际上与Azure Cosmos .NET SDK底层的一个已知问题相关。虽然官方声称该问题已被修复，但在某些EF Core版本中仍然会出现。问题本质上是SDK在Gateway连接模式下无法正确释放TCP套接字连接，导致连接数持续累积。

解决方案

1. 验证单例模式：可以通过调用context.Database.GetCosmosClient()方法来确认是否确实使用了单例模式的Cosmos客户端。

2. 升级SDK版本：建议直接引用最新版的Azure Cosmos .NET SDK到应用程序中，确保使用的是已修复该问题的版本。

3. 连接模式调整：考虑将连接模式从Gateway改为Direct，并利用TCPConnectionLimits配置来控制连接数。Direct模式通常能提供更好的性能和控制能力。

4. 监控与告警：建立对出站TCP连接数的监控，设置适当的告警阈值，可以在问题变得严重前及时发现并处理。

最佳实践

对于生产环境使用EF Core与CosmosDB的应用程序，建议：

• 定期检查并更新相关SDK版本
• 在非生产环境充分测试连接模式变更
• 实施全面的连接监控
• 考虑实现自动化的连接回收机制作为临时解决方案

通过以上措施，可以有效避免因连接泄漏导致的性能问题，确保应用程序的稳定运行。