// PostgreSQL 錯誤參考
PostgreSQL 25006:唯讀 SQL 交易
嘗試在唯讀交易中寫入:可能是在熱待命複本上、開啟 default_transaction_read_only 時,或是在 SET TRANSACTION READ ONLY 之後。
- SQLSTATE
25006- 名稱
read_only_sql_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在交易的早期階段。- 託管資料庫因儲存空間耗盡而切換到唯讀模式。
如何修正
-
檢查你是否在待命伺服器上,以及是否設定了唯讀模式。
SELECT pg_is_in_recovery(); SHOW default_transaction_read_only; SHOW transaction_read_only;
-
將寫入傳送到主節點。在 libpq 14 及以上版本,
target_session_attrs=read-write在連線字串中,會從清單裡挑選可寫入的主機。 -
如果角色或資料庫被錯誤地設為唯讀,請將其關閉。
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;
相關錯誤
42501權限遭拒57P03目前無法連線25001無法在交易區塊內執行1792MySQL:在唯讀交易中寫入1290MySQL:伺服器選項不允許此陳述式SQLITE_READONLYSQLite:嘗試寫入唯讀資料庫
更多無效的交易狀態錯誤
程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.
// 錯誤更少,修復更快
在 SQLly 裡操作 PostgreSQL
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。