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