Dapper 支持通过 CommandTimeout 参数设置查询超时，单位秒，本质透传至 ADO.NET；支持方法级指定、全局默认设置及结合 CancellationToken 实现端到端超时控制，优先级为：方法参数 > CommandDefinition > 全局设置 > 连接字符串 > 驱动默认值。
可以，Dapper 查询完全支持设置超时时间，核心就是 CommandTimeout 参数。它不是 Dapper 自己实现的“超时逻辑”，而是直接透传给底层 ADO.NET 的 SqlCommand.CommandTimeout（单位：秒），由数据库驱动层真正执行中断或抛出异常。
直接在方法调用中指定超时
这是最常用、最清晰的方式，优先级最高，会覆盖其他任何配置：
- 同步查询：
connection.Query(sql, param, commandTimeout: 20) - 异步查询：
await connection.QueryAsync(sql, param, commandTimeout: 30) - 执行非查询语句：
connection.Execute(sql, param, commandTimeout: 15)
全局默认超时设置
适用于大多数查询节奏一致的项目，避免每处都写重复参数：
- 设置一次即可生效：
SqlMapper.Settings.CommandTimeout = 30; - 该值为
int?类型，默认是null，表示使用数据库连接自身的默认值（通常是 30 秒） - 注意：它会被方法级
commandTimeout覆盖，不会影响已显式传参的调用
配合 CancellationToken 实现更可靠的超时控制
commandTimeout 是数据库命令级超时，但无法覆盖连接建立、DNS 解析、网络抖动等环节。要实现端到端的“最多等 20 秒”，推荐组合 CancellationToken：
聚彩手机网店系统 免费版
下载
聚彩手机商城系统，是一款专业于手机销售的独立手机网店系统，他拥有众多的手机参数选项，以及傻瓜式的设置选项，让您可以在５分钟内建立起专业而强大的手机销售网站。他拥有多套模版可以实时切换，前台拥有新闻中心、手机中心、配件中心、软件下载、手机报价、发货查询、保修查询、分店查询、产品的对比功能，代理与加盟的申请等功能，他拥有完善的会员中心，会员等级设置等，集成在线支付接口，超强ＳＥＯ，可以设置所有页面的t
- 创建带延迟的取消令牌：
var cts = new CancellationTokenSource(TimeSpan.FromSeconds(20)); - 传入异步方法：
await connection.QueryAsync(sql, param, commandTimeout: 15, cancellationToken: cts.Token); - 这样即使数据库命令没超时，整个操作也会在 20 秒后主动取消，避免线程/连接被卡住
超时优先级与避坑提醒
Dapper 按以下顺序决定最终超时值（从高到低）：
- 方法参数中的
commandTimeout -
CommandDefinition构造时传入的CommandTimeout - 全局
SqlMapper.Settings.CommandTimeout - 连接字符串里的
Connect Timeout=XX（只影响连接建立，不等于命令超时） - ADO.NET 驱动默认值（如 SqlClient 默认 30 秒）
⚠️ 不要设为 0（无限等待），容易拖垮连接池；高频简单查询建议 5–10 秒，报表类可放宽至 60–120 秒。
基本上就这些。不复杂但容易忽略的是：超时只是“失败兜底”，真正治本还得靠索引优化、SQL 重写和连接池监控。
