// PostgreSQL 錯誤參考

PostgreSQL 25006:唯讀 SQL 交易

嘗試在唯讀交易中寫入:可能是在熱待命複本上、開啟 default_transaction_read_only 時,或是在 SET TRANSACTION READ ONLY 之後。

SQLSTATE
25006
名稱
read_only_sql_transaction
類別
無效的交易狀態
錯誤訊息
cannot execute INSERT in a read-only transaction

它的意義

PostgreSQL 拒絕 INSERT, UPDATE, DELETE,在交易為唯讀時執行 DDL 和其他寫入。連到串流複製的備援節點時就會遇到(那裡的所有交易都是唯讀),或當 default_transaction_read_only 適用於伺服器、資料庫或角色,或者在交易開始時 READ ONLY.

訊息會指出被拒絕的命令名稱。

常見原因

  • 連線可能連到了讀取副本,例如透過負載平衡器,或是在容錯移轉後指向待命伺服器的 DNS 名稱。
  • default_transaction_read_only = on 設定在資料庫或角色上,有時是特意為報表使用者而設。
  • BEGIN READ ONLY 或 SET TRANSACTION READ ONLY 在交易的早期階段。
  • 託管資料庫因儲存空間耗盡而切換到唯讀模式。

如何修正

  1. 檢查你是否在待命伺服器上,以及是否設定了唯讀模式。

    SELECT pg_is_in_recovery();
    SHOW default_transaction_read_only;
    SHOW transaction_read_only;
  2. 將寫入傳送到主節點。在 libpq 14 及以上版本, target_session_attrs=read-write 在連線字串中,會從清單裡挑選可寫入的主機。

  3. 如果角色或資料庫被錯誤地設為唯讀,請將其關閉。

    ALTER ROLE app SET default_transaction_read_only = off;
    ALTER DATABASE shop SET default_transaction_read_only = off;

安全地重現問題

BEGIN READ ONLY;
CREATE TEMP TABLE t (id int);  -- ERROR: cannot execute CREATE TABLE in a read-only transaction
ROLLBACK;

相關錯誤

更多無效的交易狀態錯誤

程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。