如何解决Azure SQL DB托管身份认证下的连接池超时问题

针对你遇到的使用用户分配托管身份认证时随机出现连接池超时，SQL认证正常的问题，可从以下几个方向排查解决：

一、排查DbContext生命周期与连接释放 #

1. 检查服务注册：确保没有长生命周期（如Singleton）的服务依赖Transient的MYDBContext，否则会导致DbContext被长期持有，连接无法归还到池。
2. 调整查询执行逻辑：你的AsEnumerable()属于延迟执行，改为ToList()强制立即执行，能确保查询完成后连接及时回收：

public Page? GetPage(string pageUrl, Guid eventId, Guid phaseId, string releaseAuthtoken = "")
{
    string sql = "EXECUTE [Admin].[uspGetPage] @PageUrl,@EventId,@PhaseId,@ReleaseAuthtoken";
    var parms = new[]
    {
        new SqlParameter("@PageUrl",pageUrl),
        new SqlParameter("@EventId", eventId),
        new SqlParameter("@PhaseId", phaseId),
        new SqlParameter("@ReleaseAuthtoken", releaseAuthtoken),
    };
    var pageList = _context.Page.FromSqlRaw<Page>(sql, parms).ToList();
    return pageList.FirstOrDefault();
}

二、优化连接池配置 #

托管身份认证下，连接池的连接因包含令牌信息，复用逻辑与SQL认证不同，调整以下配置：

• 缩短Connection Timeout：从300秒改为30秒，避免无效连接长时间占用池资源。
• 添加Connection Lifetime=300：强制连接池每5分钟清理过期连接，防止因令牌失效导致的无效连接积累。
• 降低Max Pool Size：从2024调整为150左右，托管身份连接开销更高，过大的池大小会导致资源浪费。

修改后的连接字符串：

Server=tcp:<ServerName>.database.windows.net,1433;Initial Catalog=<DBNAME>;Persist Security Info=False;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;Min Pool Size=0;Max Pool Size=150;Pooling=True;Connection Lifetime=300;Authentication=Active Directory Managed Identity;User Id=<MI Object Id>

三、升级Microsoft.Data.SqlClient版本 #

5.1.1版本存在托管身份认证相关的连接池已知问题，升级到最新稳定版（如5.2.x及以上）可修复此类bug。

四、监控连接池状态 #

添加简单的监控代码，查看连接池的活跃/空闲连接数，确认问题根源：

// 在查询前后添加监控
var stats = SqlConnection.RetrieveStatistics();
Console.WriteLine($"活跃连接数：{stats["ActiveConnections"]}，空闲连接数：{stats["FreeConnections"]}");

也可以通过Azure应用服务诊断工具，查看连接池相关指标。

五、手动管理令牌（可选） #

如果上述方案无效，可手动获取托管身份令牌并设置到连接，绕过客户端的令牌缓存逻辑：

// 示例：手动获取令牌（需实现GetManagedIdentityToken方法）
var token = GetManagedIdentityToken("https://database.windows.net/");
using var conn = new SqlConnection(conString.Replace("Authentication=Active Directory Managed Identity;", ""));
conn.AccessToken = token;
conn.Open();
// 执行存储过程查询

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