re:re:actable
Урок 102 минуты чтения

Зачем нужны транзакции и защита от гонок

На этой странице
Кратко

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

Вопрос

Как создать две связанные записи и не оставить половину результата при ошибке?

Основная идея

Допустим, кнопка создает пару учебных задач. Если первая запись создана, а вторая завершилась ошибкой, пользователь должен получить либо всю пару, либо ничего. Для этого нужны BEGIN, COMMIT и ROLLBACK.

Пример: одна транзакция на одном соединении

// lib/task-transaction.ts
import "server-only";
import { z } from "zod";
import { pool } from "./db";
import { requireUser } from "./session";
 
export async function createTaskPair(raw: unknown) {
  const user = await requireUser();
  const titles = z.tuple([
    z.string().trim().min(1).max(200),
    z.string().trim().min(1).max(200),
  ]).parse(raw);
  const client = await pool.connect();
  try {
    await client.query("BEGIN");
    for (const title of titles) {
      await client.query(
        "INSERT INTO tasks(owner_id, title) VALUES ($1, $2)",
        [user.id, title],
      );
    }
    await client.query("COMMIT");
  } catch (error) {
    await client.query("ROLLBACK");
    throw error;
  } finally {
    client.release();
  }
}

Вызывай эту функцию из Action или API, не из рендера страницы. Обе записи используют один client: отдельные вызовы pool.query могли бы попасть на разные соединения.

Что важно помнить

Транзакция сама по себе не отменяет все гонки. Для покупки последнего товара опасна схема «прочитать остаток → проверить в JavaScript → уменьшить». Надежнее атомарный запрос с условием WHERE stock > 0, проверка числа обновленных строк и нужные ограничения.

Для сложных сценариев применяют блокировки SELECT ... FOR UPDATE, версию записи или подходящий уровень изоляции. Взаимоблокировки и конфликты сериализации могут требовать ограниченного повтора всей транзакции.

Не держи транзакцию открытой, пока ждешь внешний платежный API. Изменения внешней системы не откатятся вместе с PostgreSQL; для них проектируют идемпотентность, статусы и надежную доставку событий.

Мини-шпаргалка

  • Одна транзакция — одно соединение.
  • Ошибка ведет к откату, соединение освобождается в finally.
  • Атомарность и защита от гонок — связанные, но разные задачи.
  • Внешний HTTP-вызов не входит автоматически в транзакцию БД.

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам