// PostgreSQL 错误参考

PostgreSQL 25001:无法在事务块中运行

一些命令(VACUUM、CREATE DATABASE、CREATE INDEX CONCURRENTLY、ALTER SYSTEM)必须单独运行,不能在 BEGIN ... COMMIT 里执行。

SQLSTATE
25001
名称
active_sql_transaction
类别
无效的事务状态
错误信息
CREATE INDEX CONCURRENTLY cannot run inside a transaction block

它的意思

少数 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 块,它始终在事务内运行。

如何修复它

  1. 在开启自动提交的情况下单独运行该命令。在 psql 中这是默认行为;只需不要将其放在 BEGIN 和 COMMIT.

    CREATE INDEX CONCURRENTLY orders_customer_id_idx ON orders (customer_id);
  2. 在你的驱动程序中,为该语句开启自动提交(psycopg: conn.autocommit = True).

  3. 在迁移工具中,将迁移标记为非事务性的;大多数框架都有此选项。

  4. 将每个此类命令作为单独的查询发送,而不是将它们组合在一个字符串中。

安全地复现它

BEGIN;
VACUUM;  -- ERROR: VACUUM cannot run inside a transaction block
ROLLBACK;

相关错误

更多无效事务状态错误

代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。