PostgreSQL 25001:无法在事务块中运行
一些命令(VACUUM、CREATE DATABASE、CREATE INDEX CONCURRENTLY、ALTER SYSTEM)必须单独运行,不能在 BEGIN ... COMMIT 里执行。
- SQLSTATE
25001- 名称
active_sql_transaction- 类别
- 无效的事务状态
它的意思
少数 PostgreSQL 命令会自行管理事务或者无法回滚,因此它们拒绝在显式事务块中运行: VACUUM, CREATE DATABASE, DROP DATABASE, CREATE INDEX CONCURRENTLY, REINDEX ... CONCURRENTLY, ALTER SYSTEM, CREATE TABLESPACE 以及其他命令。连续执行会 BEGIN 会报 25001 错误(active_sql_transaction).
问题在于,许多工具和驱动会为你开启事务:迁移框架会将每次迁移包装在事务中,关闭自动提交的客户端会隐式启动事务。
常见原因
- 迁移框架会在事务中运行每一个迁移。
- 客户端或驱动程序关闭了自动提交(psycopg2 的默认设置,JDBC 使用
setAutoCommit(false)),因此每条语句都在事务中。 - 一个脚本将多个语句作为一个多语句查询字符串发送,PostgreSQL 会将其作为单个隐式事务执行。
- 从函数或
DO块,它始终在事务内运行。
如何修复它
-
在开启自动提交的情况下单独运行该命令。在 psql 中这是默认行为;只需不要将其放在
BEGIN和COMMIT.CREATE INDEX CONCURRENTLY orders_customer_id_idx ON orders (customer_id);
-
在你的驱动程序中,为该语句开启自动提交(psycopg:
conn.autocommit = True). -
在迁移工具中,将迁移标记为非事务性的;大多数框架都有此选项。
-
将每个此类命令作为单独的查询发送,而不是将它们组合在一个字符串中。
安全地复现它
BEGIN; VACUUM; -- ERROR: VACUUM cannot run inside a transaction block ROLLBACK;
相关错误
更多无效事务状态错误
代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.
在 SQLly 中使用 PostgreSQL
适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。