// справочник ошибок PostgreSQL

PostgreSQL 55P03: блокировка недоступна

Запрос блокировки не стал ждать: использован NOWAIT либо истёк lock_timeout, пока другая сессия держала конфликтующую блокировку.

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 истёк, обычно на DDL, таком как 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

Безопасное воспроизведение

Выполняйте в двух соединениях; по завершении закройте сеанс 1 командой ROLLBACK.

-- 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 или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с PostgreSQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.