// PostgreSQL 错误参考

PostgreSQL 40P01:检测到死锁

两个或多个事务在互相等待对方的锁。PostgreSQL 回滚了其中一个,让另一个得以完成;请重试失败的那个事务。

SQLSTATE
40P01
名称
deadlock_detected
类别
事务回滚
错误信息
deadlock detected
DETAIL:  Process 1234 waits for ShareLock on transaction 5678; blocked by process 4321.
Process 4321 waits for ShareLock on transaction 8765; blocked by process 1234.

它的意思

死锁是锁等待的循环:事务 A 持有事务 B 需要的锁,同时等待事务 B 持有的锁。双方都无法继续,因此当锁等待持续时间达到 deadlock_timeout (默认 1 秒)过后,PostgreSQL 会检查是否存在循环,一旦发现就以 40P01 中止其中一个事务。

被中止的事务会完全回滚,另一个事务继续进行。 DETAIL 这些行显示了涉及的进程以及 CONTEXT 行会指出是哪条语句在等待。

常见原因

  • 两个事务以不同顺序更新相同的行,例如,一个从账户 1 转账到账户 2,而另一个则从账户 2 转账到账户 1。
  • 外键:插入子行需要一个 FOR KEY SHARE 父行上的锁,这可能与另一个正在更新该父行的事务发生冲突。
  • 触及大量行的长事务,会拉大锁顺序重叠的时间窗口。
  • 显式 LOCK TABLE 或者 SELECT ... FOR UPDATE 在不同的代码路径中以不同的顺序获取。

如何修复它

  1. 重试失败的事务。死锁是并发时的正常结果,应用程序应捕获 SQLSTATE 40P01 (和 40001)并再次运行整个事务。

  2. 在任何地方都以一致的顺序获取锁,例如总是先锁定较低的 ID。

    BEGIN;
    SELECT * FROM accounts WHERE id IN (1, 2) ORDER BY id FOR UPDATE;
    UPDATE accounts SET balance = balance - 100 WHERE id = 1;
    UPDATE accounts SET balance = balance + 100 WHERE id = 2;
    COMMIT;
  3. 保持事务简短:先进行读取和计算,然后再写入,并及时提交。

  4. 开启 log_lock_waits 因此,等待时间超过 deadlock_timeout 会连同所涉及的语句一起被记录,接着去查看服务器日志。

    ALTER SYSTEM SET log_lock_waits = on;
    SELECT pg_reload_conf();

安全地复现它

在一个临时数据库上,按顺序在两个独立的连接中运行这些步骤。

-- Session 1:
CREATE TABLE dl (id int PRIMARY KEY, v int);
INSERT INTO dl VALUES (1, 0), (2, 0);
BEGIN; UPDATE dl SET v = 1 WHERE id = 1;
-- Session 2:
BEGIN; UPDATE dl SET v = 2 WHERE id = 2;
UPDATE dl SET v = 2 WHERE id = 1;   -- waits
-- Session 1:
UPDATE dl SET v = 1 WHERE id = 2;   -- one session gets ERROR: deadlock detected

问题

发生死锁时,PostgreSQL 会中止哪个事务?

死锁检测时先发现环的那个,这一点通常无法预测。编写每个事务时都要保证它可以重试。

相关错误

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

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

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