可以,Dapper 查询完全支持设置超时时间,核心就是 CommandTimeout 参数。它不是 Dapper 自己实现的“超时逻辑”,而是直接透传给底层 ADO.NET 的
SqlCommand.CommandTimeout(单位:秒),由数据库驱动层真正执行中断或抛出异常。
直接在方法调用中指定超时
这是最常用、最清晰的方式,优先级最高,会覆盖其他任何配置:
同步查询:connection.Query<t>(sql, param, commandTimeout: 20)</t>异步查询:
await connection.QueryAsync<t>(sql, param, commandTimeout: 30)</t>执行非查询语句:
connection.Execute(sql, param, commandTimeout: 15)
全局默认超时设置
适用于大多数查询节奏一致的项目,避免每处都写重复参数:
设置一次即可生效:SqlMapper.Settings.CommandTimeout = 30;该值为
int?类型,默认是
null,表示使用数据库连接自身的默认值(通常是 30 秒) 注意:它会被方法级
commandTimeout覆盖,不会影响已显式传参的调用
配合 CancellationToken 实现更可靠的超时控制
commandTimeout是数据库命令级超时,但无法覆盖连接建立、DNS 解析、网络抖动等环节。要实现端到端的“最多等 20 秒”,推荐组合
CancellationToken: 创建带延迟的取消令牌:
var cts = new CancellationTokenSource(TimeSpan.FromSeconds(20));传入异步方法:
await connection.QueryAsync<t>(sql, param, commandTimeout: 15, cancellationToken: cts.Token);</t>这样即使数据库命令没超时,整个操作也会在 20 秒后主动取消,避免线程/连接被卡住
超时优先级与避坑提醒
Dapper 按以下顺序决定最终超时值(从高到低):
方法参数中的commandTimeout
CommandDefinition构造时传入的
CommandTimeout全局
SqlMapper.Settings.CommandTimeout连接字符串里的
Connect Timeout=XX(只影响连接建立,不等于命令超时) ADO.NET 驱动默认值(如 SqlClient 默认 30 秒)
⚠️ 不要设为
0(无限等待),容易拖垮连接池;高频简单查询建议 5–10 秒,报表类可放宽至 60–120 秒。
基本上就这些。不复杂但容易忽略的是:超时只是“失败兜底”,真正治本还得靠索引优化、SQL 重写和连接池监控。
