设置400秒命令超时却出现2秒超时异常的原因排查

已将Dapper命令超时设置为400秒，未显式定义连接超时（使用默认值），连接字符串也未配置超时参数，但出现了仅发生一次的2秒超时异常。

异常信息：

Execution Timeout Expired. The timeout period elapsed prior to completion of the operation or the server is not responding

相关代码：

try
{
    Dapper.SqlMapper.Settings.CommandTimeout = Convert.ToInt32(400); //in secs
    SqlConnection connection = new SqlConnection();
    var data = connection.Query<MyClass>("MySP").ToList();
}
catch (Exception ex)
{
    _logger.LogWrite(ex.ToString());
    throw ex;
}
finally
{
    watch.Stop();
    var elapsedSec = watch.ElapsedMilliseconds / 1000;
    _logger.LogWrite("Execution time in Seconds: " + elapsedSec);
}

可能的原因分析 #

• 连接阶段的偶发超时：你设置的是命令执行超时，但连接建立阶段的超时由SQL Server默认连接超时或网络设备规则决定。如果当时数据库连接池瞬间耗尽、DNS解析延迟、TCP握手被防火墙/负载均衡临时截断，可能会出现短于默认连接超时的异常，这类情况通常是偶发的。
• 数据库端的局部超时设置：存储过程MySP内部可能通过SET LOCK_TIMEOUT 2000设置了锁等待超时为2秒，或者数据库端的查询超时策略被临时调整。即使客户端设置了长命令超时，数据库端的局部设置会优先触发超时，锁冲突这类场景只会偶发出现。
• 数据库服务器临时资源瓶颈：异常发生时数据库服务器可能出现CPU、内存、磁盘IO瞬时峰值，导致查询无法被及时调度，甚至服务器短暂无响应，触发客户端超时。这类资源波动通常是偶发的，和客户端配置无关。
• 全局命令超时的偶发失效：如果代码运行在多线程环境下，其他线程可能修改了SqlMapper.Settings.CommandTimeout这个全局配置；或者Dapper在特定场景（比如连接已提前打开）下未正确读取全局超时，不过这种情况导致2秒超时的概率较低。
• 网络链路临时异常：网络瞬间丢包、路由切换等偶发问题，会导致客户端与数据库的通信中断，触发超时。这类网络问题在分布式环境中很常见，通常仅出现一次。

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