Что такое…

Что такое мьютекс — и зачем «замок» коду, у которого один поток

Иллюстрация: одна дверь с единственным ключом на крючке и очередь из одинаковых коробок перед ней

Слово «мьютекс» обычно живёт в учебниках про потоки. И кажется: JavaScript однопоточный, значит, мне это не нужно.

А потом пользователь открывает твоё приложение в двух вкладках. Обе одновременно решают обновить токен входа. Одна успевает, вторая отправляет уже использованный токен — и человека выкидывает из аккаунта. Без всяких потоков.

Лечится это ровно мьютексом. Давай разберёмся, что это за зверь.

Что такое мьютекс

Мьютекс — это замок, который пускает к ресурсу только одного за раз. Название от английского mutual exclusion — «взаимное исключение».

Представь туалет в кафе с одним ключом на стойке. Взял ключ — зашёл. Остальные ждут, пока ключ не вернётся. Двое одновременно войти не могут — ключ-то один.

В коде всё так же:

  1. Код хочет поработать с общим ресурсом — например, с балансом или токеном.
  2. Сначала он берёт замок.
  3. Делает работу.
  4. Отпускает замок.

Пока замок занят, другие желающие ждут своей очереди. Кусок кода между «взял» и «отпустил» называют критической секцией.

Зачем он нужен, если поток один

Потому что баг возникает не от потоков, а от ожидания. Это и есть состояние гонки.

Смотри на обычную оплату:

async function pay() {
  const paid = await checkIfPaid()  // ждём сервер...
  if (!paid) await charge()         // ...и списываем
}

Пользователь кликнул дважды. Первый вызов дошёл до await и встал ждать сервер. Пока он ждёт, стартует второй вызов. Оба спросили «уже оплачено?», оба услышали «нет». Оба списали деньги.

Поток был один. Но асинхронный код отдаёт управление на каждом await — и в эту щель пролезает соседний вызов. Мьютекс закрывает щель: второй вызов ждёт, пока первый не закончит целиком.

Мьютекс в браузере: Web Locks

В браузере есть встроенный мьютекс, о котором мало кто знает, — navigator.locks. Он работает во всех современных браузерах. И главное — между вкладками одного сайта.

Вот защита от той самой истории с двумя вкладками:

await navigator.locks.request("refresh-token", async () => {
  if (tokenIsFresh()) return     // соседняя вкладка уже обновила
  const token = await refreshToken()
  saveToken(token)
})

Как это работает:

  • Первая вкладка берёт замок с именем "refresh-token" и обновляет токен.
  • Вторая встаёт в очередь и ждёт.
  • Когда очередь доходит до неё, она проверяет: токен уже свежий? Да — значит, ничего делать не надо.

Обрати внимание на проверку внутри. Без неё вторая вкладка просто дождалась бы своей очереди и всё равно обновила бы токен. Замок выстраивает очередь, а проверка внутри не даёт сделать работу дважды.

Ещё плюс: замок отпускается сам, когда функция закончилась. Даже если внутри вылетела ошибка.

Мьютекс в базе данных

Деньги, остатки на складе, места в зале — всё это живёт в базе. И там свой замок. В Postgres это FOR UPDATE:

BEGIN;
SELECT balance FROM accounts WHERE id = 42 FOR UPDATE;
-- строка заперта: другие запросы к ней ждут
UPDATE accounts SET balance = balance - 100 WHERE id = 42;
COMMIT; -- замок снят

Пока транзакция не закончилась, второй запрос к той же строке встанет и подождёт. Два одновременных списания не смогут оба прочитать старый баланс.

Это надёжнее, чем замок в браузере. Пользователь может открыть сайт с телефона и ноутбука сразу — браузерный замок этого не увидит. А база видит всех.

Где мьютекс кусается

Замок — сильное лекарство, и у него две побочки.

  • Забыл отпустить — все встали. Если замок взят вручную и код упал до «отпустить», очередь ждёт вечно. Поэтому отпускай в finally или бери инструменты, которые отпускают сами, как navigator.locks.
  • Два замка в разном порядке — взаимная блокировка. Первый держит замок А и ждёт Б. Второй держит Б и ждёт А. Оба ждут друг друга бесконечно. Правило простое: если нужно несколько замков, бери их всегда в одном и том же порядке.

И не запирай лишнего. Чем дольше держишь замок, тем длиннее очередь. Внутри критической секции — только то, что правда трогает общий ресурс.

Чем мьютекс отличается от семафора?

Мьютекс пускает одного. Семафор пускает до N одновременно — как парковка на десять мест. Семафор удобен, чтобы ограничить, например, число параллельных запросов к API.

Хватит ли просто заблокировать кнопку после клика?

Для двойного клика в одной вкладке — да, это первый и самый дешёвый шаг. Но от второй вкладки, второго устройства и повторного запроса по сети кнопка не спасёт. Там нужен замок на сервере или в базе.

Мьютекс замедляет приложение?

Немного — пока один работает, другие ждут. Но ждут только те, кто лезет к тому же ресурсу. Если критическая секция короткая, разницы никто не заметит, а двойных списаний не будет.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →