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 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 SQL Server 和你使用的其他資料庫。