Deadlock в PostgreSQL: воспроизведение и устранение | ТЕРАКОР
Назад PostgreSQL / SQL
PostgreSQL / SQL Средний (Middle) обновлено 18.11.2026 ~7 мин чтения

Транзакции и deadlock в PostgreSQL: воспроизведение и устранение

Как воспроизводить и устранять deadlock в PostgreSQL: единый порядок блокировок, короткие транзакции, уровни изоляции, ретраи victim и мониторинг конфликтов.

Редакция ТЕРАКОР
Автор Редакция ТЕРАКОР Основатель ТЕРАКОР, практикующий разработчик и Tech Lead
Транзакции и deadlock в PostgreSQL: воспроизведение и устранение

Deadlock — не «мистика базы», а конкурирующий порядок блокировок между сессиями. Команда должна уметь воспроизвести сценарий двумя соединениями и устранить причину в коде, а не увеличивать таймауты вслепую. В PostgreSQL одна из транзакций становится victim и откатывается: прикладной слой обязан корректно повторить операцию, если она идемпотентна.

На практике ТЕРАКОР видит deadlock там, где обновляют связанные сущности в разном порядке, держат транзакцию открытой на время HTTP-вызова или смешивают длинные отчёты с OLTP в одной схеме блокировок.

Как устроен конфликт

Сессия A блокирует строку заказа, затем строку склада. Сессия B делает наоборот. Обе ждут друг друга — движок обнаруживает цикл и прерывает одну транзакцию. Симптом в логах приложения: сериализация ошибки deadlock, внезапный rollback, повтор пользователя «на всякий случай» без ключа идемпотентности усугубляет нагрузку.

Метод разбора

  1. Соберите логи deadlock PostgreSQL и пары конфликтующих запросов (включая приложение request id).
  2. Воспроизведите на стенде двумя psql/сессиями с теми же UPDATE/SELECT FOR UPDATE.
  3. Нарисуйте граф ресурсов: какие таблицы/строки в каком порядке берутся.
  4. Унифицируйте порядок захвата в коде всех сервисов, пишущих в эти сущности.
  5. Сократите транзакцию: уберите внешние вызовы, файлы и долгие вычисления из транзакционной границы.

Инструменты

Полезны pg_stat_activity, логи с log_lock_waits, трассы приложения. Для обучения — обязательный лабораторный стенд с двумя сессиями: Junior должен увидеть victim своими глазами, а не только прочитать теорию.

Профилактика в прикладном коде

  • Единый глобальный порядок обновления сущностей (например, всегда account → order → order_item).
  • Короткие транзакции: сначала вычислили, потом коротко записали.
  • Осторожный SELECT FOR UPDATE: только нужные строки, без лишних диапазонов.
  • Идемпотентные ретраи на deadlock victim с ограниченным числом попыток и backoff.
  • Очередь для тяжёлых операций вместо удержания блокировок в HTTP-запросе.

Уровни изоляции

Не поднимайте изоляцию «на всякий случай». Сначала устраните конфликт порядка блокировок. Повышение до REPEATABLE READ/SERIALIZABLE без понимания аномалий добавляет задержки и новые конфликты сериализации. Выбирайте уровень осознанно под бизнес-инвариант и измеряйте число ошибок сериализации.

Мониторинг

Следите за числом deadlocks в единицу времени и за длительностью ожидания блокировок. Рост после релиза — повод разбирать конкретный PR, а не крутить deadlock_timeout как «лечение». Алерт должен вести в runbook: найти пару запросов, воспроизвести, исправить порядок, выкатить патч.

Связь с очередями и outbox

Длинная транзакция «записали заказ + отправили в брокер + обновили склад» — частый источник блокировок. Разделяйте: транзакция данных + outbox, публикация вне блокировок строк. Это снижает и deadlock, и время удержания lock.

Что писать в постмортем

  1. Какие ресурсы и в каком порядке конфликтовали.
  2. Какой код путь исправлен (единый порядок / укорочение транзакции).
  3. Как покрыто тестом или стендовым сценарием двух сессий.
  4. Какие метрики подтвердили исчезновение симптома.

Паттерны, которые провоцируют deadlock

  • Обработка списка id в том порядке, в котором пришёл JSON, без сортировки по PK перед UPDATE.
  • «Умный» сервис A обновляет order→payment, сервис B — payment→order.
  • Триггеры и каскады, неочевидно берущие дополнительные блокировки.
  • Долгие транзакции отчётного скрипта на тех же строках, что и онлайн-касса.

Перед массовой обработкой сортируйте идентификаторы одинаково во всех воркерах. Это простой приём, который убирает целый класс циклов блокировок при пакетных UPDATE.

Лабораторный стенд для команды

Выделите 30 минут на практику: два окна psql, таблица accounts с балансом, сценарий перевода. Покажите victim, затем исправление порядка и ретрай в PHP/любом клиенте. После такого упражнения обсуждение «давайте увеличим timeout» на ретро проходит иначе. ТЕРАКОР включает этот стенд в SQL-практику backend-модуля.

Ретраи на уровне приложения

Обработчик deadlock должен быть узким: повторять только безопасные/идемпотентные операции, с потолком попыток и журналированием. Слепой бесконечный retry превращает редкий конфликт в шторм. Для пользовательского HTTP-запроса после исчерпания попыток верните 409/503 с понятным кодом — клиент сможет повторить осознанно.

В очередях помечайте ошибку deadlock как retryable, но с backoff. Свяжите метрику victim с дашбордом релиза: всплеск после выкладки — почти всегда новый порядок блокировок в коде.

Документ порядка блокировок

Для доменов с частыми конфликтами (балансы, склад, бронирования) заведите одностраничный регламент: перечень сущностей и канонический порядок UPDATE/FOR UPDATE. Новый сервис обязан следовать документу на ревью. Это дешевле, чем каждый раз искать цикл по логам production после релиза.

Связь с advisory locks

Иногда вместо блокировки многих строк удобнее взять advisory lock на бизнес-ключ операции. Это не отменяет порядок блокировок строк там, где они нужны, но снижает площадь конфликта для «процессим один заказ целиком». Используйте осознанно и документируйте ключ лока в коде.

Вывод ТЕРАКОР

Deadlock лечится инженерией блокировок и границ транзакций, а не магическими таймаутами. Навык воспроизведения двумя сессиями обязателен для backend-разработчика, работающего с PostgreSQL в production. Закрепите единый порядок ресурсов, короткие транзакции, идемпотентные ретраи и мониторинг конфликтов — и «мистика базы» исчезнет из чатов дежурств.

Уровни изоляции

Не поднимайте изоляцию «на всякий случай». Сначала устраните конфликт порядка блокировок. Повышение изоляции без понимания аномалий добавляет задержки и новые конфликты.

Мониторинг

Следите за числом deadlocks и длительностью ожидания блокировок. Рост этих метрик — повод для разбора релиза, а не для увеличения timeout вслепую.

Обсуждение во ВКонтакте

Войдите через VK, чтобы оставить комментарий. Сообщения видны друзьям и подписчикам.

Практика

Задачники по теме

Закрепите материал на задачах с критериями проверки.

2 задачника

Все задачники