Visual Studio调试大存储过程查询仅调试场景触发SqlException超时错误

1. 调整命令超时配置 #

Dapper 调用查询时默认的CommandTimeout仅为30秒，该值和SSMS默认的0（永不超时）不同，也和连接字符串中的Connection Timeout（仅控制连接建立超时，和命令执行无关）是两个独立配置。
调试环境下因为调试器附加的性能开销、调试库数据分布差异，大查询很容易超过30秒阈值。你可以在调用Query方法时显式指定更长的超时时间，示例修改后的代码如下：

using (SqlConnection conn = new SqlConnection(CONNECTION_STRING))
{
   partialReport = conn.Query<MonthlyReporting>(
       "PartialReport", 
       new { ClassLevel = (int)instruct, StartDate = startDate, EndDate = endDate, IncludeMarried = includeMarried }, 
       commandType: CommandType.StoredProcedure,
       commandTimeout: 120 // 单位为秒，可根据实际情况调整
   ).ToList();

   // program does stuff here
}

2. 排查参数嗅探问题 #

该问题是SQL Server存储过程常见的性能异常原因：存储过程的执行计划会根据首次调用的参数生成，若后续调用的参数范围差异极大，错误复用执行计划会导致查询效率骤降。
因为你调试库和线上库的调用历史、数据统计信息不同，很容易出现该问题，可通过两种方式验证：

• 执行SQL命令清空调试库的存储过程缓存后重试：DBCC FREEPROCCACHE
• 直接在存储过程的查询语句末尾添加OPTION (RECOMPILE)，强制每次调用生成新的执行计划

3. 关闭调试环境额外性能开销 #

VS调试模式下默认开启的IntelliTrace、托管调试助手、或者断点暂停执行都会拉长查询的实际执行时间，触发超时。可以先通过以下方式验证：

• 临时关闭VS的调试辅助功能，直接用Ctrl+F5非调试模式运行程序，看是否还会触发超时
• 确认调试时没有在存储过程执行过程中触发断点暂停

4. 校验连接字符串差异 #

检查调试和线上环境的连接字符串配置，排除以下问题：

• 调试环境连接字符串用了命名管道、共享内存等低速通信协议，而非TCP/IP
• 调试环境连接字符串开启了不必要的跟踪、上下文连接等额外参数，增加通信开销

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