// PostgreSQL 错误参考

PostgreSQL 55P03:锁不可用

锁请求放弃等待:使用了 NOWAIT,或在另一个会话持有冲突锁时锁超时已到期。

SQLSTATE
55P03
名称
lock_not_available
类别
对象不处于先决条件状态
错误信息
could not obtain lock on row in relation "orders"

它的意思

通常 PostgreSQL 会一直等待锁直到拿到。55P03 表示该语句被告知不要等: SELECT ... FOR UPDATE NOWAIT 或者 LOCK TABLE ... NOWAIT 若锁已被占用就立即失败,而当 lock_timeout 设置之后,任何语句只要等满这个时长就会失败。锁超时会报出 canceling statement due to lock timeout 使用相同的代码。

持有锁的其他会话不受影响。在事务块内,失败的语句会使事务中止。

常见原因

  • FOR UPDATE NOWAIT, FOR SHARE NOWAIT 或者 LOCK TABLE ... NOWAIT 碰到另一个事务已锁定的行或表。
  • A lock_timeout 过期,通常是在诸如 ALTER TABLE,它需要独占锁,得排在长时间运行的查询后面等待。
  • 一个长事务或一个在事务中保持锁而处于空闲状态的会话。

如何修复它

  1. 找到持有锁的会话。

    SELECT pid, usename, state, xact_start, query
    FROM pg_stat_activity
    WHERE pid IN (
        SELECT unnest(pg_blocking_pids(pid)) FROM pg_stat_activity
    );
  2. 对于作业队列,跳过已锁定的行,而不是报错。

    SELECT id FROM jobs
    WHERE status = 'queued'
    ORDER BY id
    LIMIT 10
    FOR UPDATE SKIP LOCKED;
  3. 对于模式更改,请使用较短的 lock_timeout 是刻意为之,然后重试,这样 ALTER 不会排在长查询后面,把其他人都堵住。

    SET lock_timeout = '3s';
    ALTER TABLE orders ADD COLUMN note text;
  4. 结束或缩短阻塞事务;如果它被遗弃,则终止它。

    SELECT pg_terminate_backend(12345);  -- the blocking pid

安全地复现它

在两个连接中运行;之后用 ROLLBACK 结束会话 1。

-- Session 1:
CREATE TABLE q (id int PRIMARY KEY);
INSERT INTO q VALUES (1);
BEGIN; SELECT * FROM q WHERE id = 1 FOR UPDATE;
-- Session 2:
SELECT * FROM q WHERE id = 1 FOR UPDATE NOWAIT;  -- ERROR: could not obtain lock on row in relation "q"

相关错误

更多对象未处于前提状态的错误

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

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

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