如何让外部库使用已开启的SQL事务？（C#环境，无法修改库代码）

这个问题我之前也碰到过——当你手动开启了SqlConnection的本地事务，但外部库的SqlCommand没设置Transaction属性时，就会抛出这个异常。好在有几种不用修改外部库代码的解决方案，我给你详细讲讲：

方案一：使用TransactionScope（推荐，无侵入） #

这是最优雅的解决方案，利用.NET的**环境事务（Ambient Transaction）**机制，不需要外部库做任何改动。原理是：当你在TransactionScope的范围内操作数据库时，所有符合条件的数据库连接和命令都会自动登记到这个事务中，不需要显式设置Transaction属性。

步骤和代码示例 #

1. 确保你的项目引用了System.Transactions程序集（.NET Core/.NET 5+默认已包含，.NET Framework需要手动添加引用）。
2. 用using块包裹你的事务逻辑：

using System.Transactions;

// ...

using (var transactionScope = new TransactionScope())
{
    // 初始化你的SqlConnection（如果连接已存在，确保它还未参与其他事务）
    using (var connection = new SqlConnection("你的数据库连接字符串"))
    {
        connection.Open();
        
        // 调用外部库的方法，传入这个连接
        ExternalLibraryClass.DoDatabaseOperations(connection);
    }
    
    // 提交事务：只有调用了Complete()，事务才会真正提交
    transactionScope.Complete();
}

关键注意点 #

• 单数据库事务不需要MSDTC：很多人误以为TransactionScope必须开启MSDTC，但只要你只操作单个数据库，它会使用轻量级事务，完全不需要依赖MSDTC服务。
• 超时设置：默认事务超时是1分钟，如果你的操作耗时较长，可以在创建TransactionScope时指定超时：

  var scopeOptions = new TransactionOptions
  {
      Timeout = TimeSpan.FromMinutes(10) // 设置10分钟超时
  };
  using (var transactionScope = new TransactionScope(TransactionScopeOption.RequiresNew, scopeOptions))
  {
      // ...
  }
  

• 连接状态：如果你的连接在进入TransactionScope之前已经打开，需要确保它没有参与其他本地事务，否则可能会触发分布式事务提升（如果跨资源的话）。

方案二：自定义SqlConnection包装类（hack方案，仅当TransactionScope不可用） #

如果因为某些环境限制不能用TransactionScope，可以通过自定义SqlConnection子类，自动给创建的SqlCommand绑定事务。不过这个方案有局限性，需要外部库通过connection.CreateCommand()创建命令：

public class TransactionAwareSqlConnection : SqlConnection
{
    private SqlTransaction _currentTransaction;

    public TransactionAwareSqlConnection(string connectionString) : base(connectionString)
    {
    }

    public new SqlTransaction BeginTransaction()
    {
        _currentTransaction = base.BeginTransaction();
        return _currentTransaction;
    }

    public new SqlCommand CreateCommand()
    {
        var command = base.CreateCommand();
        if (_currentTransaction != null)
        {
            command.Transaction = _currentTransaction;
        }
        return command;
    }
}

使用方式：

using (var connection = new TransactionAwareSqlConnection("你的连接字符串"))
{
    connection.Open();
    using (var transaction = connection.BeginTransaction())
    {
        try
        {
            ExternalLibraryClass.DoDatabaseOperations(connection);
            transaction.Commit();
        }
        catch
        {
            transaction.Rollback();
            throw;
        }
    }
}

如果外部库是直接通过new SqlCommand(sql, connection)创建命令，这个方案就会失效，所以优先级不如TransactionScope。

为什么PHP/Doctrine的方式在C#里不适用？ #

在Doctrine中，ORM内部会自动管理事务与查询的绑定，开启事务后后续的查询会自动关联到当前事务。但C#的SqlClient是更底层的API，它要求显式关联SqlCommand和SqlTransaction——当连接处于本地事务中时，所有命令必须明确指定Transaction属性，否则就会抛出你遇到的异常。而TransactionScope通过环境事务机制绕开了这个显式绑定的要求，让命令自动关联到当前事务。

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