Aspire中SQL Server连接事务错误排查求助

核心问题 #

这个错误的本质是：你正在使用的SqlConnection已经处于一个未完成的本地事务中，但执行的SqlCommand没有关联这个事务。结合Aspire的使用场景，问题大概率出在事务处理和Aspire连接注入的配合上，而非单纯的Aspire配置遗漏。

具体排查与修复点 #

1. 手动开启事务时必须关联到Command #

如果你的代码里是手动调用conn.BeginTransaction()开启事务，一定要把事务对象赋值给后续执行的SqlCommand.Transaction属性，否则就会触发这个报错：

using var transaction = await conn.BeginTransactionAsync();
try
{
    var cmd = conn.CreateCommand();
    cmd.Transaction = transaction; // 这步不能省！
    cmd.CommandText = "INSERT INTO Customers (Name) VALUES (@Name)";
    cmd.Parameters.AddWithValue("@Name", "Test");
    await cmd.ExecuteNonQueryAsync();
    
    await transaction.CommitAsync();
}
catch
{
    await transaction.RollbackAsync();
    throw;
}

2. 优先用Aspire适配的事务管理方式 #

Aspire不推荐手动操作Connection事务，更建议用TransactionScope或者EF Core的IDbContextTransaction来统一管理事务，避免手动关联的麻烦：
比如用TransactionScope（需要先注册服务）：

// 项目Program.cs中注册事务工厂
builder.Services.AddTransient<ITransactionScopeFactory, TransactionScopeFactory>();

// 业务代码中使用
using var scope = _transactionScopeFactory.Create(TransactionScopeOption.Required);
await _sqlConnection.ExecuteAsync("INSERT INTO ...");
await _sqlConnection.ExecuteAsync("UPDATE ...");
scope.Complete(); // 完成事务

3. 检查Aspire配置是否正常 #

你的现有配置（宿主加Aspire.Hosting.SqlServer，业务项目加Aspire.Microsoft.Data.SqlClient，配置数据库引用）是没问题的，Aspire默认支持事务，不需要额外开启配置。但要确保没有在配置时手动禁用了事务相关的默认行为（一般不会这么做）。

4. 避免连接生命周期冲突 #

Aspire注入的SqlConnection默认是Scoped生命周期，同一个Scope里如果多次开启事务但没正确提交/回滚，会导致连接一直处于待处理事务状态。务必用using块包裹事务操作，确保事务及时收尾。

内容的提问来源于stack exchange，提问作者3xGuy