PostgreSQL / 系统课时

读取 deadlock detected 日志

读取 deadlock detected 日志

本课解决一个直接问题:拿到 PostgreSQL 的 deadlock detected 日志后,如何从看似零散的 PID、事务号、锁模式和 SQL 中还原“谁在等谁”。读完后,你应能把一条死锁日志整理成可复盘的证据链,而不是只盯着被回滚的那条语句。

学习目标

  • 识别 ERROR、DETAIL、CONTEXT、STATEMENT 各自提供的证据。
  • 正确解释进程 PID、事务 ID、等待锁与阻塞者之间的关系。
  • 区分“被选为牺牲者的语句”和“造成死锁的完整事务顺序”。

先截取完整的死锁事件

排查时不要只复制 ERROR: deadlock detected 一行。至少要保留同一事件中的 DETAIL、HINT、CONTEXT 与 STATEMENT,并向前后多取几行时间戳和连接标识。下面假设服务器日志文件位于 <PATH>/postgresql-<TIME>.log,实际路径和文件名会因 log_directory、日志轮转策略而不同。

bash
grep -A 12 -B 2 "deadlock detected" <PATH>/postgresql-<TIME>.log

预期输出会包含类似的完整片段;PID、事务 ID、tuple 位置与时间都属于动态值:

text
<TIME> ERROR:  deadlock detected
<TIME> DETAIL:  Process 4201 waits for ShareLock on transaction 9102; blocked by process 4202.
        Process 4202 waits for ShareLock on transaction 9101; blocked by process 4201.
        Process 4201: UPDATE accounts SET balance = balance - 100 WHERE id = 2;
        Process 4202: UPDATE accounts SET balance = balance - 50 WHERE id = 1;
<TIME> HINT:  See server log for query details.
<TIME> CONTEXT:  while updating tuple (<ID>,<ID>) in relation "accounts"
<TIME> STATEMENT:  UPDATE accounts SET balance = balance - 100 WHERE id = 2;

grep 只负责把事件上下文取全;它不会告诉你根因。下一步要按字段拆解。

从 DETAIL 先建立阻塞关系

DETAIL 中最重要的是两类句子:Process A waits for ...; blocked by process B 描述等待边,Process A: SQL 描述当时该进程正在执行的语句。以上例为例,可以直接得到两条关系:

等待进程 等待对象 阻塞进程 当前 SQL
4201 ShareLock on transaction 9102 4202 更新 id = 2
4202 ShareLock on transaction 9101 4201 更新 id = 1

这里的 ShareLock 是对 transaction ID 的锁等待,不要误读成“对表拿了 ShareLock”。行级 UPDATE 冲突时,等待方常常表现为等待对方事务结束,因此日志会写成对 transaction 的锁等待。

两个等待边互相指回对方,已经形成闭环:4201 等 4202,4202 又等 4201。deadlock detected 的核心证据就在这里。

再读 CONTEXT 与 STATEMENT

CONTEXT 用来补充错误发生时数据库内部正在处理什么,例如更新哪个关系、哪个 tuple。它能帮助确认冲突发生在 accounts 表,但 tuple 的物理位置不是稳定业务主键,不能直接拿来当长期定位依据。

STATEMENT 是收到错误的那个后端当时执行的语句。它通常对应 PostgreSQL 为打破死锁而中止的事务,但“被中止”不等于“根因事务”。死锁是多个事务共同形成的环,不能因为某个会话收到错误就把责任只归到它。

把日志整理成证据链

一次可复盘的死锁记录至少应回答四个问题:哪些 PID 参与、每个 PID 在等谁、等待的锁对象是什么、每个 PID 当时执行什么 SQL。若日志前缀还包含数据库名、用户名、application_name、会话 ID 或时间戳,也应一并保留,用来关联应用侧请求。

最终不要写成“某条 UPDATE 死锁了”,而应写成“进程 4201 与 4202 形成相互等待闭环;4201 等待事务 9102,4202 等待事务 9101;两条当前 SQL 分别访问 accounts.id=2 与 accounts.id=1;仍需结合事务内前序语句确认各自先持有的资源”。这样的描述才足以进入后续的等待图还原与代码修复。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

读取 deadlock detected 日志

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通