// 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 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。