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 就能真正跑在异步流水线上，而不是假装异步。