Deadlock — не «мистика базы», а конкурирующий порядок блокировок между сессиями. Команда должна уметь воспроизвести сценарий двумя соединениями и устранить причину в коде, а не увеличивать таймауты вслепую. В PostgreSQL одна из транзакций становится victim и откатывается: прикладной слой обязан корректно повторить операцию, если она идемпотентна.
На практике ТЕРАКОР видит deadlock там, где обновляют связанные сущности в разном порядке, держат транзакцию открытой на время HTTP-вызова или смешивают длинные отчёты с OLTP в одной схеме блокировок.
Как устроен конфликт
Сессия A блокирует строку заказа, затем строку склада. Сессия B делает наоборот. Обе ждут друг друга — движок обнаруживает цикл и прерывает одну транзакцию. Симптом в логах приложения: сериализация ошибки deadlock, внезапный rollback, повтор пользователя «на всякий случай» без ключа идемпотентности усугубляет нагрузку.
Метод разбора
- Соберите логи deadlock PostgreSQL и пары конфликтующих запросов (включая приложение request id).
- Воспроизведите на стенде двумя psql/сессиями с теми же UPDATE/SELECT FOR UPDATE.
- Нарисуйте граф ресурсов: какие таблицы/строки в каком порядке берутся.
- Унифицируйте порядок захвата в коде всех сервисов, пишущих в эти сущности.
- Сократите транзакцию: уберите внешние вызовы, файлы и долгие вычисления из транзакционной границы.
Инструменты
Полезны 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.
Что писать в постмортем
- Какие ресурсы и в каком порядке конфликтовали.
- Какой код путь исправлен (единый порядок / укорочение транзакции).
- Как покрыто тестом или стендовым сценарием двух сессий.
- Какие метрики подтвердили исчезновение симптома.
Паттерны, которые провоцируют 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, чтобы оставить комментарий. Сообщения видны друзьям и подписчикам.