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