SQL Server 错误 266:EXECUTE 后事务计数不匹配
存储过程或批处理结束时,打开的事务数量与开始时不同:有 BEGIN TRANSACTION 却没有 COMMIT,或者多执行了一次 ROLLBACK。
- 错误编号
266- 严重性
- 16
- 类别
- 事务与锁定
它的意思
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在嵌套过程内发生运行时错误后,回滚了整个事务。
如何修复它
-
检查
@@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; -
确保每条退出路径都使事务保持平衡。将裸写的
RETURN语句包进一个事务里,再跳转到唯一一个提交或回滚的出口。 -
当工具或驱动需要跨多条语句使用事务时,请用驱动的事务 API 来开启,或发送
BEGIN TRANSACTION作为普通批处理,而不是作为参数化sp_executesql调用。 -
如果 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 以及你使用的其他数据库。