Dapper 本身不直接管理事务，它依赖 ADO.NET 的
SqlTransaction（或其他数据库对应的 Transaction 类型）来实现事务控制。所谓“Dapper 异步事务”，其实是使用支持异步的 ADO.NET API（如
BeginTransactionAsync、
CommitAsync、
RollbackAsync）配合 Dapper 的异步方法（如
ExecuteAsync、
QueryAsync）来完成——关键在于把同一个
SqlTransaction实例显式传给每个 Dapper 调用。
1. 使用 BeginTransactionAsync 创建异步事务
在打开连接后，调用
connection.BeginTransactionAsync()获取事务对象。注意：必须确保连接已打开（Dapper 不会自动帮你打开），且事务生命周期与连接绑定。 连接需手动
OpenAsync()，否则抛异常 事务对象要保存下来，后续所有 Dapper 操作都需传入它 不要在 using 块里提前释放连接或事务，否则可能引发“连接已关闭”错误
2. 所有 Dapper 异步操作必须显式传入 transaction 参数
Dapper 的异步方法（如
ExecuteAsync、
QueryFirstOrDefaultAsync）都有重载支持传入
IDbTransaction。漏传就等于没走事务——它会走默认的自动提交模式。 正确写法：
conn.ExecuteAsync(sql, param, transaction)错误写法：
conn.ExecuteAsync(sql, param)（脱离事务上下文） 多个操作共用同一个 transaction 实例，才能保证原子性
3. 手动控制 CommitAsync / RollbackAsync
事务结束后，必须显式调用
transaction.CommitAsync()或
transaction.RollbackAsync()。推荐用 try/catch 包裹业务逻辑，出异常时回滚。 未调用 CommitAsync → 数据不会持久化（即使连接关闭，事务也会自动回滚） 未捕获异常导致 RollbackAsync 被跳过 → 可能造成连接挂起或数据不一致 建议配合
using或
try/finally确保事务终态被处理
4. 完整示例（SQL Server）
（注意：实际项目中建议封装为 service 方法或使用 UnitOfWork 模式）
using var conn = new SqlConnection(connectionString);
await conn.OpenAsync();
<p>using var transaction = await conn.BeginTransactionAsync();</p><p>try
{
await conn.ExecuteAsync("INSERT INTO Orders (...) VALUES (...)", order, transaction);
await conn.ExecuteAsync("UPDATE Products SET Stock = Stock - @Qty WHERE Id = @Pid", stockParam, transaction);</p><pre class="brush:php;toolbar:false;">await transaction.CommitAsync();} catch { await transaction.RollbackAsync(); throw; }
基本上就这些。Dapper 异步事务不是魔法，核心就是「一个连接 + 一个开启的异步事务 + 所有操作显式传参 + 显式提交或回滚」。不复杂但容易忽略 transaction 参数传递这一步。
