Что такое дедлок — и почему ошибка «deadlock detected» тебя спасла

Смотри, парадокс: ошибка «deadlock detected» выглядит как катастрофа, а на самом деле это спасение. База нашла в твоём коде вечное зависание, убила одну транзакцию и спасла остальные. Настоящая беда — не эта ошибка, а дедлок, который никто не обнаружил.
Что такое дедлок простыми словами
Представь двух человек за одним столом. Каждому нужны ручка и бумага. Первый схватил ручку и ждёт бумагу. Второй схватил бумагу и ждёт ручку. Никто не отдаст своё, пока не получит чужое. Оба будут ждать вечно.
Это и есть дедлок — взаимная блокировка. В базе данных он выглядит так:
- Транзакция A заблокировала строку 1 и хочет строку 2.
- Транзакция B заблокировала строку 2 и хочет строку 1.
- Обе ждут друг друга. Навсегда.
Ключевое слово — кольцо. A ждёт B, B ждёт A. Ожидание замкнулось само на себя.
Чем дедлок отличается от «просто тормозит»
Обычное ожидание конечно: кто-то держит строку, закончит — отпустит. Медленно, но живо.
Дедлок бесконечен по построению. Ни один участник кольца не может закончить, потому что ждёт другого участника кольца. Время не лечит — хоть час жди.
И не путай с состоянием гонки. Гонка — двое бегут наперегонки, и результат зависит от того, кто успел первым. Дедлок — не финиширует вообще никто.
Живой пример: два перевода навстречу
Классика, на которой дедлок ловят чаще всего, — деньги. Алиса переводит Бобу, и в ту же миллисекунду Боб переводит Алисе. Каждый перевод — транзакция из двух SQL-команд:
-- перевод Алиса → Боб -- перевод Боб → Алиса
UPDATE accounts UPDATE accounts
SET balance = balance - 100 SET balance = balance - 50
WHERE name = 'alice'; WHERE name = 'bob';
-- строка Алисы заперта -- строка Боба заперта
UPDATE accounts UPDATE accounts
SET balance = balance + 100 SET balance = balance + 50
WHERE name = 'bob'; -- ждёт WHERE name = 'alice'; -- ждёт
Первая транзакция заперла Алису и ждёт Боба. Вторая заперла Боба и ждёт Алису. Кольцо готово. Заметь: по отдельности каждая транзакция безупречна — дедлок рождается только из их встречного порядка.
Как база находит дедлок сама
Тут самое интересное. Postgres не надеется, что дедлоков не будет. Он дежурит.
Если транзакция ждёт блокировку дольше секунды, база строит граф «кто кого ждёт» и ищет в нём кольцо. Нашла — выбирает одну транзакцию-жертву и убивает её с ошибкой «deadlock detected». Кольцо разомкнулось, остальные поехали дальше.
Поэтому эта ошибка — хорошая новость: сторож сработал.
А вот в обычном коде — потоки, async-задачи, два мьютекса — такого сторожа нет. Программа просто виснет. Без ошибки, без сообщения. Дедлок в базе громкий, дедлок в коде тихий — и тихий опаснее.
Как писать код без дедлоков
Три правила закрывают почти все случаи.
- Один порядок захвата. Дедлок возможен, только если ресурсы берут в разном порядке. Договорись с собой: все обновляют строки по возрастанию id — и кольцу неоткуда взяться. Обновляешь два счёта? Отсортируй их id перед транзакцией.
- Короткие транзакции. Не жди внутри транзакции ничего медленного: запроса к API, ответа пользователя. Чем меньше держишь блокировку, тем меньше окно для кольца.
- Повторяй после ошибки. Поймал «deadlock detected» — не паникуй, а перезапусти транзакцию. Это штатный сценарий: жертву выбрали, кольца больше нет, вторая попытка почти всегда проходит.
Дедлок — это баг в базе данных?
Нет. База лишь честно обнаруживает кольцо, которое создал порядок операций в твоём коде. Чинить нужно код — обычно достаточно единого порядка захвата.
У новичка вообще бывают дедлоки?
Да, легко: два вебхука одновременно обновляют одни и те же две строки, но в разном порядке. Пока пользователь один — всё работает. Появились параллельные запросы — начались случайные «deadlock detected».
Программа зависла без ошибки — это дедлок?
Возможно. Если зависание вечное и наступает при параллельной работе — подозревай кольцо ожидания в коде. Перезапусти и добавь лог: кто какой ресурс взял и чего ждёт. Кольцо станет видно по логам.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





