// PostgreSQL 错误参考

PostgreSQL 40001:无法序列化访问

在 REPEATABLE READ 或 SERIALIZABLE 隔离级别下,另一个并发事务修改了本事务依赖的数据。PostgreSQL 将其回滚;请重试整个事务。

SQLSTATE
40001
名称
serialization_failure
类别
事务回滚
错误信息
could not serialize access due to concurrent update

它的意思

PostgreSQL 的更高隔离级别保证事务看到的是一致性快照。当因为另一个事务提交了冲突的更改而无法保持该保证时,PostgreSQL 会以 40001 中止其中一个事务,而不是返回在串行顺序中不可能出现的结果。

消息会根据原因有所不同: could not serialize access due to concurrent update 或者 concurrent delete (你试图修改的行在你的快照之后被别人改过了),以及 could not serialize access due to read/write dependencies among transactions (SERIALIZABLE 检测到危险模式)。解决方法相同:从头再次运行事务。

常见原因

  • 两个 REPEATABLE READ 或者 SERIALIZABLE 两个事务更新同一行;后提交的那个失败。
  • A SERIALIZABLE 事务读取了随后被另一个事务更改的行,这种模式可能会产生异常。
  • 由多个并发可串行化事务更新的热点行,例如计数器或余额。

如何修复它

  1. 重试。使用 REPEATABLE READ 或者 SERIALIZABLE 必须捕获 SQLSTATE 40001 并把整个事务连同其中的读取一起重跑几次,每次间隔短暂退避。

  2. 保持可串行化事务简短,尽量少涉及行。

  3. 如果这项工作不需要可串行化,默认的 READ COMMITTED 级别会在更新时重新读取最新的行版本,而不是直接报错。

    BEGIN ISOLATION LEVEL READ COMMITTED;
    UPDATE counters SET n = n + 1 WHERE name = 'visits';
    COMMIT;
  4. 在 SERIALIZABLE,将只读事务如实声明; SERIALIZABLE READ ONLY DEFERRABLE 永远不会因序列化错误而失败。

    BEGIN ISOLATION LEVEL SERIALIZABLE READ ONLY DEFERRABLE;

安全地复现它

在临时数据库上用两个独立连接运行。

-- Session 1:
CREATE TABLE acct (id int PRIMARY KEY, bal int);
INSERT INTO acct VALUES (1, 100);
BEGIN ISOLATION LEVEL REPEATABLE READ;
SELECT bal FROM acct WHERE id = 1;
-- Session 2:
UPDATE acct SET bal = 50 WHERE id = 1;
-- Session 1:
UPDATE acct SET bal = bal - 10 WHERE id = 1;  -- ERROR: could not serialize access due to concurrent update
ROLLBACK;

相关错误

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

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

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