Dapper 的
QueryAsync方法通过底层 ADO.NET 的异步 API（如
DbCommand.ExecuteReaderAsync）实现真正的异步查询，避免线程阻塞，提升高并发场景下的吞吐量。它不是简单地把同步调用包在
Task.Run里，而是依赖数据库驱动对异步 I/O 的支持（如 SqlClient 从 .NET 4.5+ 开始原生支持）。
QueryAsync 基本用法
只需将原来的
Query<t></t>替换为
QueryAsync<t></t>，并用
await调用即可： 方法签名返回
Task<ienumerable>></ienumerable>，必须
await连接需已打开，或由 Dapper 自动打开（推荐显式管理生命周期） 参数传递方式与同步版完全一致（匿名对象、DynamicParameters 等）
示例：
using (var conn = new SqlConnection(connectionString))
{
await conn.OpenAsync();
var users = await conn.QueryAsync<User>(
"SELECT * FROM Users WHERE Age > @minAge",
new { minAge = 18 });
}配合 DynamicParameters 使用
处理复杂参数（如输出参数、表值参数、空值判断）时，用
DynamicParameters更安全灵活： 支持
Add方法指定参数方向（
DbType、
Direction、
IsNullable等） 可添加多个同名参数（Dapper 会自动去重或按顺序绑定） 支持输出参数读取（需
await后再访问
.Get<t>()</t>）
示例（带输出参数）：
<pre class="brush:php;toolbar:false;">var p = new DynamicParameters();
p.Add("@name", "Alice", DbType.String);
p.Add("@count", dbType: DbType.Int32, direction: ParameterDirection.Output);
<p>await conn.QueryAsync("SELECT * FROM Users WHERE Name = @name; SET @count = @@ROWCOUNT;", p);
int resultCount = p.Get<int>("@count");批量查询与多结果集（QueryMultipleAsync）
一次往返执行多个 SQL 并获取多个结果集，适合关联数据一次性加载：
用QueryMultipleAsync执行含多个
SELECT的语句（用分号分隔） 返回
SqlMapper.GridReader，支持链式调用
ReadAsync<t>()</t>多次 每个
ReadAsync对应一个结果集，类型独立推断
示例：
<pre class="brush:php;toolbar:false;">var sql = @"
SELECT * FROM Users WHERE Active = 1;
SELECT COUNT(*) FROM Orders WHERE UserId IN (SELECT Id FROM Users WHERE Active = 1);";
<p>using var multi = await conn.QueryMultipleAsync(sql);
var users = await multi.ReadAsync<User>();
var orderCount = await multi.ReadSingleAsync<int>();注意事项与常见坑
异步不是万能的，用错反而降低性能：
不要在非异步上下文中用.Result或
.Wait()强制同步等待，可能引发死锁（尤其 ASP.NET 同步上下文） 确保整个调用链是异步的（Controller → Service → Repository），否则异步红利丢失 连接字符串需启用异步（SQL Server 默认开启；MySQL/PostgreSQL 驱动需确认版本是否支持）
QueryAsync返回的是
IEnumerable<t></t>的
Task，不是
List<t></t>；如需立即枚举或多次遍历，请
await ...ToListAsync()（需引用
System.Data.Common扩展）
基本上就这些。用对了 QueryAsync，Dapper 就能真正跑在异步流水线上，而不是假装异步。
