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