// SQL Server 错误参考

SQL Server 错误 266:EXECUTE 后事务计数不匹配

存储过程或批处理结束时,打开的事务数量与开始时不同:有 BEGIN TRANSACTION 却没有 COMMIT,或者多执行了一次 ROLLBACK。

错误编号
266
严重性
16
类别
事务与锁定
错误信息
Transaction count after EXECUTE indicates a mismatching number of BEGIN and COMMIT statements. Previous count = %ld, current count = %ld.

它的意思

SQL Server 统计打开事务数的位置是 @@TRANCOUNT。当存储过程、触发器或 RPC 调用(例如 sp_executesql)返回时,SQL Server 会把该计数与进入时的值比较。如果两者不一致,就会引发 266,告诉你该模块让事务状态失去了平衡。

此错误是对事务代码结构的一个警告。存储过程内部的工作已经执行;接下来会怎样,取决于调用方是提交还是回滚仍然打开的事务,或是从未开启一个后来被回滚的事务。

常见原因

  • 存储过程运行了 BEGIN TRANSACTION 并提前返回(一个 IF ... RETURN,或错误路径)而不 COMMIT 或者 ROLLBACK.
  • 存储过程运行了 ROLLBACK TRANSACTION 在其调用方打开的事务内。 ROLLBACK 始终回滚到最外层的事务并设置 @@TRANCOUNT 为 0,因此调用者的计数不再匹配。
  • 一个客户端库或工具发送一个 BEGIN TRANSACTION 通过 sp_executesql (一次 RPC 调用)并期望它在以后的语句中保持打开状态。
  • SET XACT_ABORT ON 在嵌套过程内发生运行时错误后,回滚了整个事务。

如何修复它

  1. 检查 @@TRANCOUNT 在存储过程开始处,并且仅当尚无事务时才开启(并在稍后提交)事务。嵌套的工作请用保存点,这样出错时只会回滚存储过程自身的更改。

    CREATE OR ALTER PROCEDURE dbo.TransferFunds @From int, @To int, @Amount money
    AS
    BEGIN
        SET NOCOUNT ON;
        DECLARE @OwnTran bit = CASE WHEN @@TRANCOUNT = 0 THEN 1 ELSE 0 END;
        IF @OwnTran = 1 BEGIN TRANSACTION;
        ELSE SAVE TRANSACTION TransferFunds;
        BEGIN TRY
            UPDATE dbo.Accounts SET Balance -= @Amount WHERE AccountId = @From;
            UPDATE dbo.Accounts SET Balance += @Amount WHERE AccountId = @To;
            IF @OwnTran = 1 COMMIT TRANSACTION;
        END TRY
        BEGIN CATCH
            IF @OwnTran = 1 AND @@TRANCOUNT > 0 ROLLBACK TRANSACTION;
            ELSE IF XACT_STATE() = 1 ROLLBACK TRANSACTION TransferFunds;
            THROW;
        END CATCH
    END;
  2. 确保每条退出路径都使事务保持平衡。将裸写的 RETURN 语句包进一个事务里,再跳转到唯一一个提交或回滚的出口。

  3. 当工具或驱动需要跨多条语句使用事务时,请用驱动的事务 API 来开启,或发送 BEGIN TRANSACTION 作为普通批处理,而不是作为参数化 sp_executesql 调用。

  4. 如果 266 与另一个错误一起出现,请先修复那个错误。266 往往是某个失败(例如 1205 或 547)使过程回滚之后出现的第二条消息。

安全地复现它

-- Run on a scratch database.
CREATE OR ALTER PROCEDURE dbo.LeavesTranOpen AS BEGIN TRANSACTION;
GO
EXEC dbo.LeavesTranOpen;   -- Msg 266: Previous count = 0, current count = 1
SELECT @@TRANCOUNT;        -- 1: the transaction is still open
ROLLBACK;
DROP PROCEDURE dbo.LeavesTranOpen;

问题

错误 266 会回滚我的更改吗?

不会。266 本身不会回滚任何内容。过程内部所做的更改仍然属于当前打开的事务;如果调用方提交,它们会被保留;如果回滚,则会被撤销。检查 @@TRANCOUNT ,就在调用之后。

为什么应用程序会收到 266 错误,SSMS 里却没有?

许多驱动程序通过 sp_executesql,这是 SQL Server 用来检查事务计数是否配平的 RPC 调用。SSMS 会把你的文本当作普通批次发送,因此 BEGIN TRANSACTION 它就那样保持打开。

相关错误

更多事务和锁定错误

代码和消息文本来自 Microsoft 数据库引擎事件和错误参考。浏览完整的 SQL Server 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 SQL Server

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQL Server 以及你使用的其他数据库。