(2026年10月29日 追記:記事どおりに再現できるよう、必要なコードと手順を追加しました)
予約サービスで最も避けたいトラブルのひとつが、同じ部屋・同じ時間に2人の予約が入ってしまう「ダブルブッキング(二重予約)」です。起きてしまうと、どちらかのお客様にお詫びと返金をすることになり、信頼にも関わります。前回の予約フォーム(第3回)では、入力チェックをして予約を保存できるようになりました。ところが、実はまだ二重予約を完全には防げていません。
「予約システムを作るとき、同じ時間に2人が予約してしまう二重予約はどうやって防ぐのですか?『空いているか確認してから保存』では足りないのですか?」
先に結論をお伝えします。「空きを確認してから保存する」だけでは、ほぼ同時に2人が操作したときにすり抜けます。確実に防ぐには、データベース自身に「重なる予約は保存させない」というルールを持たせます。今回は PostgreSQL の「排他制約」を使い、実際に10人が同時に同じ枠を予約しても1件しか通らないことをテストで確かめます。
「空き確認してから保存」が二重予約を防げない理由
第3回の予約処理は、次の2段階で動いていました。
- その日の予約済みの時間を読み出して、重なっていないか確認する
- 重なっていなければ、予約を保存する
1と2のあいだには、わずかな時間があります。この隙間に、別の人が同じ枠で1から2まで進んでしまうと、どちらの確認も「空いている」という結果になり、両方が保存されます。人がボタンを押すタイミングが偶然そろう、というより、スマホの通信が遅れた、画面を開いたまま放置していた、といったごく普通の理由で起こります。
実際に、第3回までのコードで5件を同時に送るテストを書いて動かしたところ、次の結果になりました(開発環境での確認です)。
成功 5 DB件数 5
5件とも成功し、同じ時間の予約が5件保存されました。画面の入力チェックを増やしても、サーバー側の確認を丁寧にしても、「確認してから保存」の形である限り、この隙間は埋まりません。
仕組み:重なりを禁止する「排他制約」
そこで、確認の役目をアプリではなくデータベースに任せます。PostgreSQL には、排他制約(=「この条件に当てはまる行を同時に2つ持ってはいけない」というルール)という仕組みがあります。
📰 出典:PostgreSQL 16 公式ドキュメント「Constraints(排他制約)」
予約では、次の条件を「同時に存在してはいけない組み合わせ」として登録します。
| 条件 | 意味 |
|---|---|
スペースが同じ(space_id WITH =) | 同じ部屋の予約どうし |
時間帯が重なる(tstzrange(starts_at, ends_at) WITH &&) | 開始から終了までの範囲が少しでも重なる |
この2つが両方成り立つ予約が入ろうとすると、データベースが保存を拒否します。データベースは同時に来た保存を内部で順番に処理するため、「確認と保存のあいだの隙間」がそもそも存在しません。
時間帯の範囲には tstzrange(タイムゾーンつきの時間範囲を表す型)を使います。これは「開始を含み、終了を含まない」範囲として扱われるので、10〜12時の予約と12〜14時の予約は重なりません。連続して借りたい場合が普通に通ります。
📰 出典:PostgreSQL 16 公式ドキュメント「Range Types」
実装1:マイグレーションに制約を追加する
Drizzle ORM のスキーマ定義では排他制約を書けないため、自分で SQL を書くマイグレーション(=データベースの構造を変更する手順書)として追加します。drizzle-kit generate --custom で空のファイルが作られるので、そこに SQL を書きます。
📰 出典:Drizzle ORM 公式ドキュメント「Custom migrations」
npx drizzle-kit generate --custom --name=prevent_double_booking
作られたファイル drizzle/0003_prevent_double_booking.sql には「ここに SQL を書く」という1行のコメントだけが入っています。中身を、次の内容に置き換えます(-- で始まる行は説明のコメントです)。
-- drizzle/0003_prevent_double_booking.sql
-- 二重予約を DB 自身に防がせる。アプリ側の「空きを確認してから保存」だけでは、同時アクセスですり抜けるため。
-- 1) 「スペースが同じ」かつ「時間帯が重なる」予約の同時存在を禁止する(排他制約)。
-- = の比較を GiST 索引で扱うために btree_gist 拡張が要る。
CREATE EXTENSION IF NOT EXISTS btree_gist;--> statement-breakpoint
-- 2) 終了が開始より後であることを保証する(逆転した時間帯は排他制約でも意図どおり扱えないため)
ALTER TABLE "reservations" ADD CONSTRAINT "reservations_time_order_check" CHECK ("ends_at" > "starts_at");--> statement-breakpoint
-- tstzrange は '[)'(開始を含み終了を含まない)なので、10-12時と12-14時のような「隣り合う」予約は重ならない扱いになる
ALTER TABLE "reservations" ADD CONSTRAINT "reservations_no_overlap" EXCLUDE USING gist ("space_id" WITH =, tstzrange("starts_at", "ends_at") WITH &&);
ポイントは3つです。
btree_gist拡張:「space_idが等しい」という比較と「範囲が重なる」という比較を、ひとつの排他制約で組み合わせるために必要です。PostgreSQL に標準で同梱されている拡張ですが、有効化の操作が要ります。- CHECK 制約:終了が開始より前になっている予約を保存できなくします。時間が逆転したデータは、重なりの判定が意図どおりにならないためです。
--> statement-breakpoint:Drizzle が SQL を1文ずつ実行するための区切りです。
なお、schema.ts には制約そのものを書けないので、「制約は SQL ファイルにある」とコメントを残しておきます。後から読んだ人が見落とさないための工夫です。
lib/schema.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/lib/schema.ts
+++ b/lib/schema.ts
@@ -15,6 +15,8 @@ export const spaces = pgTable("spaces", {
export type Space = typeof spaces.$inferSelect;
// 予約の表。時刻は timestamptz(タイムゾーンつき)で持ち、DB 内では UTC として扱われる。
+// 二重予約を防ぐ制約(排他制約)は Drizzle のスキーマでは書けないため、
+// drizzle/0003_prevent_double_booking.sql に SQL で書いてある(第4回)。
export const reservations = pgTable(
"reservations",
{
マイグレーションを適用します。
docker compose up -d # データベースを起動(起動済みなら不要)
DATABASE_URL=postgres://yoyaku:yoyaku@localhost:5432/yoyaku npm run db:migrate
実装2:制約違反を「想定内の失敗」として扱う
制約を付けると、重なる予約を保存しようとしたとき、データベースがエラーを返します。PostgreSQL のエラーコードでは 23P01(排他制約の違反)にあたります。
📰 出典:PostgreSQL 16 公式ドキュメント「Error Codes」
これは「先に誰かが予約した」という起こりうる出来事なので、画面を壊すエラーにはせず、利用者に伝わるメッセージに変えます。lib/reservations.ts を次のように変更しました。
第3回で作った lib/reservations.ts に次の変更を加えます(+ が追加、- が削除)
--- a/lib/reservations.ts
+++ b/lib/reservations.ts
@@ -4,20 +4,39 @@ import { reservations } from "./schema";
import type { BookingInput } from "./booking";
import type { TimeRange } from "./slots";
-// 予約を保存する。保存の直前に重なりを確かめているが、同時アクセスですり抜ける余地がある(第4回で DB の制約で塞ぐ)
-export async function insertReservation(spaceId: number, booking: BookingInput, range: TimeRange) {
- const [row] = await getDb()
- .insert(reservations)
- .values({
- spaceId,
- startsAt: range.startsAt,
- endsAt: range.endsAt,
- contactName: booking.contactName,
- contactEmail: booking.contactEmail,
- attendees: booking.attendees,
- })
- .returning({ id: reservations.id });
- return row;
+// PostgreSQL のエラーコード 23P01 = exclusion_violation(排他制約に違反した)
+const EXCLUSION_VIOLATION = "23P01";
+
+// Drizzle は DB のエラーを別のエラーで包むため、cause をたどって元のエラーコードを探す
+export function isExclusionViolation(error: unknown): boolean {
+ for (let e: unknown = error; e instanceof Error; e = e.cause) {
+ if ((e as { code?: unknown }).code === EXCLUSION_VIOLATION) return true;
+ }
+ return false;
+}
+
+export type InsertResult = { ok: true; id: number } | { ok: false; reason: "conflict" };
+
+// 保存の最終的な番人は DB の排他制約。重なる予約が先に入っていれば保存に失敗し、conflict を返す。
+// 排他制約への違反は「想定している失敗」なので例外にせず結果として返し、それ以外のエラーはそのまま投げる。
+export async function insertReservation(spaceId: number, booking: BookingInput, range: TimeRange): Promise<InsertResult> {
+ try {
+ const [row] = await getDb()
+ .insert(reservations)
+ .values({
+ spaceId,
+ startsAt: range.startsAt,
+ endsAt: range.endsAt,
+ contactName: booking.contactName,
+ contactEmail: booking.contactEmail,
+ attendees: booking.attendees,
+ })
+ .returning({ id: reservations.id });
+ return { ok: true, id: row.id };
+ } catch (error) {
+ if (isExclusionViolation(error)) return { ok: false, reason: "conflict" };
+ throw error;
+ }
}
// 完了画面用。個人情報(名前・メール)は返さない
つまずきやすいのが cause をたどる部分です。Drizzle は DB のエラーをそのまま返さず、別のエラーで包んで投げます。包みの外側を見ただけでは 23P01 が見つからないため、cause を順にたどって探しています。
呼び出し側の Server Action では、conflict のときにフォームへエラーを返します。
app/spaces/[slug]/reserve/actions.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/app/spaces/[slug]/reserve/actions.ts
+++ b/app/spaces/[slug]/reserve/actions.ts
@@ -26,6 +26,11 @@ export async function createReservation(slug: string, _prev: ReserveState, formD
const result = validateBooking(raw, space, booked);
if (!result.ok) return { errors: result.errors, values };
- const row = await insertReservation(space.id, result.booking, result.range);
- redirect(`/spaces/${space.slug}/reserve/done?id=${row.id}`); // redirect は例外で処理を中断する(この行より後は実行されない)
+ // 事前の空き確認(上)は親切のための早見で、確実に守るのは保存時の DB 制約。
+ // 確認と保存のあいだに他の人が先に予約していたら、ここで conflict になる。
+ const saved = await insertReservation(space.id, result.booking, result.range);
+ if (!saved.ok) {
+ return { errors: { form: "ほぼ同時に別の予約が入り、選んだ時間は埋まってしまいました。別の時間をお選びください" }, values };
+ }
+ redirect(`/spaces/${space.slug}/reserve/done?id=${saved.id}`); // redirect は例外で処理を中断する(この行より後は実行されない)
}
事前の空き確認(第3回で作った validateBooking)はそのまま残します。保存前に「重なっています」と教えられるので親切ですし、確認で弾ければデータベースに無駄な保存を試させずに済みます。早見としてのアプリの確認と、最後の番人としてのデータベース制約、という役割分担です。
動作確認:10人が同時に予約するテスト
制約が本当に効いているかは、同時アクセスを再現して確かめます。tests/double-booking.test.ts では、同じ枠への保存を10件同時に実行します。
// tests/double-booking.test.ts(抜粋)
it("同じ時間への同時の予約は、ちょうど1件だけ成功する", async () => {
await db.delete(reservations).where(eq(reservations.spaceId, spaceId));
const results = await Promise.all(Array.from({ length: 10 }, () => insertReservation(spaceId, booking, range(10, 2))));
expect(results.filter((r) => r.ok)).toHaveLength(1);
expect(results.filter((r) => !r.ok)).toHaveLength(9);
const rows = await db.select().from(reservations).where(eq(reservations.spaceId, spaceId));
expect(rows).toHaveLength(1);
});
同じファイルには、次のケースも入れています。
| ケース | 期待する結果 |
|---|---|
| 10〜12時が入っている部屋に 11〜13時 | 拒否(1時間重なる) |
| 同じく 9〜11時 | 拒否(1時間重なる) |
| 同じく 12〜13時、8〜10時 | 通る(隣り合うだけ) |
| 別のスペースの同じ時間 | 通る |
| 終了が開始より前の時間 | CHECK 制約で拒否 |
このテストは DB につながないと動かないため、DATABASE_URL が無い環境では自動的に飛ばす作りにしています。実行は次のとおりです。
テストのファイル tests/double-booking.test.ts の全文です(新しく作るファイル)。DB にテスト専用のスペースを作り、終わったら消します。
tests/double-booking.test.ts の全文(84行)
// tests/double-booking.test.ts
// DB につないで確かめるテスト。DATABASE_URL が無い環境(CI の単体テストのみ等)では飛ばす。
// 実行例: DATABASE_URL=postgres://yoyaku:yoyaku@localhost:5432/yoyaku npm test
import { eq } from "drizzle-orm";
import { afterAll, beforeAll, describe, expect, it } from "vitest";
import { createDb } from "@/lib/db";
import { insertReservation, isExclusionViolation } from "@/lib/reservations";
import { reservations, spaces } from "@/lib/schema";
import { jstDateTime } from "@/lib/slots";
const booking = { date: "2026-12-01", startHour: 10, hours: 2, attendees: 2, contactName: "テスト太郎", contactEmail: "taro@example.com" };
const range = (startHour: number, hours: number) => ({
startsAt: jstDateTime("2026-12-01", startHour),
endsAt: jstDateTime("2026-12-01", startHour + hours),
});
describe.skipIf(!process.env.DATABASE_URL)("二重予約の防止(DB 制約)", () => {
const { db, client } = createDb();
let spaceId = 0;
beforeAll(async () => {
// テスト専用のスペースを作り、他のデータに影響しないようにする
const [row] = await db
.insert(spaces)
.values({ slug: "test-double-booking", name: "テスト用", area: "テスト", description: "テスト用", capacity: 4, hourlyPriceYen: 1000 })
.onConflictDoUpdate({ target: spaces.slug, set: { name: "テスト用" } })
.returning({ id: spaces.id });
spaceId = row.id;
});
afterAll(async () => {
await db.delete(spaces).where(eq(spaces.slug, "test-double-booking")); // 予約も cascade で消える
await client.end();
});
it("同じ時間への同時の予約は、ちょうど1件だけ成功する", async () => {
await db.delete(reservations).where(eq(reservations.spaceId, spaceId));
const results = await Promise.all(Array.from({ length: 10 }, () => insertReservation(spaceId, booking, range(10, 2))));
expect(results.filter((r) => r.ok)).toHaveLength(1);
expect(results.filter((r) => !r.ok)).toHaveLength(9);
const rows = await db.select().from(reservations).where(eq(reservations.spaceId, spaceId));
expect(rows).toHaveLength(1);
});
it("一部だけ重なる予約も断り、隣り合う予約は通す", async () => {
await db.delete(reservations).where(eq(reservations.spaceId, spaceId));
expect((await insertReservation(spaceId, booking, range(10, 2))).ok).toBe(true); // 10-12時
expect((await insertReservation(spaceId, booking, range(11, 2))).ok).toBe(false); // 11-13時: 1時間重なる
expect((await insertReservation(spaceId, booking, range(9, 2))).ok).toBe(false); // 9-11時: 1時間重なる
expect((await insertReservation(spaceId, booking, range(12, 1))).ok).toBe(true); // 12-13時: 隣り合うだけ
expect((await insertReservation(spaceId, booking, range(8, 2))).ok).toBe(true); // 8-10時: 隣り合うだけ
});
it("別のスペースなら同じ時間でも予約できる", async () => {
const [other] = await db
.insert(spaces)
.values({ slug: "test-double-booking-2", name: "テスト用2", area: "テスト", description: "テスト用", capacity: 4, hourlyPriceYen: 1000 })
.onConflictDoUpdate({ target: spaces.slug, set: { name: "テスト用2" } })
.returning({ id: spaces.id });
try {
await db.delete(reservations).where(eq(reservations.spaceId, spaceId));
expect((await insertReservation(spaceId, booking, range(10, 2))).ok).toBe(true);
expect((await insertReservation(other.id, booking, range(10, 2))).ok).toBe(true);
} finally {
await db.delete(spaces).where(eq(spaces.slug, "test-double-booking-2"));
}
});
it("終了が開始より前の予約は CHECK 制約で保存できない", async () => {
const bad = { startsAt: jstDateTime("2026-12-01", 12), endsAt: jstDateTime("2026-12-01", 10) };
await expect(insertReservation(spaceId, booking, bad)).rejects.toThrow();
});
});
describe("isExclusionViolation", () => {
it("cause をたどって排他制約違反(23P01)を見つける", () => {
const inner = Object.assign(new Error("conflicting key value violates exclusion constraint"), { code: "23P01" });
expect(isExclusionViolation(new Error("Failed query", { cause: inner }))).toBe(true);
});
it("別のエラーや Error 以外では false", () => {
expect(isExclusionViolation(new Error("x", { cause: Object.assign(new Error("y"), { code: "23505" }) }))).toBe(false);
expect(isExclusionViolation("boom")).toBe(false);
});
});
DATABASE_URL=postgres://yoyaku:yoyaku@localhost:5432/yoyaku npm test
開発環境(PostgreSQL 16)では、lint・型チェック・ビルドが通り、テスト34件(今回追加した6件を含む)がすべて成功しました。制約を付ける前は5件すべて成功してしまった同時テストが、制約のあとは10件中1件だけの成功になります。
また、PostgreSQL に直接、重なる予約を入れようとすると、次のように拒否されます(開発環境での確認結果)。
ERROR: conflicting key value violates exclusion constraint "reservations_no_overlap"
なお、Docker での起動(docker compose up)は、今回の作業環境では Docker が使えず確認できていません。ローカルにインストールした PostgreSQL 16 で確認しています。
つまずきやすい点・注意
- 既存データに重なりがあると、制約を付けられません。すでに二重予約が入っているデータベースに後から制約を付けるときは、先に重なりを解消する必要があります。この連載のサンプルは新規なので問題ありませんが、運用中のシステムに追加するなら事前調査が欠かせません。
- 「仮予約」を持つ場合は条件を足します。第6〜7回で決済待ちの仮予約を扱うので、キャンセルされた予約や期限切れの仮予約は制約の対象外にする必要があります。そのときは、排他制約に
WHERE条件を付けます。次回以降で扱います。 - 事前の空き確認と制約のメッセージ両方を残す。制約だけだと、利用者は保存ボタンを押してから初めて埋まっていたと知ります。確認は親切のために、制約は確実性のために、と役割が違います。
発注者向けメモ:予約システムでこの話が出たら
二重予約の防止は、見た目の画面からは分からない部分ですが、予約・チケット・在庫・座席のように「早い者勝ちで数が限られるもの」を扱うシステムでは共通の重要論点です。
- 工数が増えやすい条件:複数の店舗・部屋を同時に扱う、仮押さえ(支払い待ち)の時間がある、キャンセル待ちがある、既存の予約データを引き継ぐ、など。
- リスクが増えやすい条件:アクセスが一時的に集中する(人気枠の販売開始など)、複数の画面・外部の予約サイトと同じ在庫を共有する、など。
- 「二重予約はどう防ぐのですか」という質問に、「確認してから保存します」だけで答える会社と、「データベース側でも防ぐ仕組みがあり、同時アクセスのテストをしています」と答える会社では、安心感が違います。
発注者がやることチェックリストと、開発会社への質問例は次のとおりです。
- ☐ 「同じものを同時に取り合う」業務(枠・席・在庫・チケット)があるか洗い出す
- ☐ 万一ダブルブッキングが起きたときの対応(お詫び・返金・代替手配)を決めておく
- ☐ 仮押さえの時間(支払い待ちを何分にするか)の希望を決めておく
- ☐ 同時アクセスのテストを納品の確認項目に入れてもらうか相談する
開発会社への質問例:
- 「二重予約は、アプリの確認だけでなくデータベース側でも防ぐ設計になっていますか?」
- 「同じ枠への同時アクセスを再現するテストは、納品物に含まれますか?」
- 「万一重なって予約が入ってしまった場合、利用者にはどのような画面・メッセージが出ますか?」
- 「仮押さえやキャンセルがある場合、枠はいつ解放されますか?」
まとめと次回予告
今回は次のことをしました。
- 「確認してから保存」だけでは、同時アクセスで二重予約がすり抜けることを、テストで再現した
- PostgreSQL の排他制約(
btree_gist+tstzrange)で、同じスペースの重なる予約を DB に拒否させた - 制約違反(
23P01)を想定内の失敗として扱い、利用者に別の時間を案内する形にした - 10件同時の保存でも1件しか通らないことを、テストで確かめた
次回の第5回では、会員ログインを付けます。メールで送るリンクから入る方式で、予約履歴を会員ごとに見られるようにする予定です。
この連載の記事一覧
この記事は連載「Next.jsで作るオンライン予約サービス」の1回です。連載のほかの回は次のとおりです(連載の一覧ページ)。
- 【Next.jsで作るオンライン予約サービス 第0回】完成像とNext.js 16の雛形を動かす(App Router・PostgreSQL・Drizzle)
- 【Next.jsで作るオンライン予約サービス 第1回】スペース一覧と詳細ページを作る(Server Components・Drizzle・メタデータ)
- 【Next.jsで作るオンライン予約サービス 第2回】空き状況カレンダーを作る(時間枠・日本時間・Drizzle)
- 【Next.jsで作るオンライン予約サービス 第3回】予約フォームをServer Actionsで作る(Zodによる入力チェックとエラー表示)
- 【Next.jsで作るオンライン予約サービス 第4回】ダブルブッキングを防ぐ(PostgreSQLの排他制約と同時アクセスのテスト)(この記事)
- 【Next.jsで作るオンライン予約サービス 第5回】会員ログインを付ける(メールのリンクで入る方式と予約履歴)
- 【Next.jsで作るオンライン予約サービス 第6回】Stripeで支払いを受ける(Checkoutとサーバー側で決める金額)
- 【Next.jsで作るオンライン予約サービス 第7回】Webhookで予約を確定する(署名の検証・二重処理の防止・仮予約の期限切れ)
- 【Next.jsで作るオンライン予約サービス 第8回】予約確認メールとキャンセル・返金(キャンセル規定・Stripeの返金・メール送信)
- 【Next.jsで作るオンライン予約サービス 第9回】管理画面を作る(管理者の権限・予約一覧・スペースの料金編集)
- 【Next.jsで作るオンライン予約サービス 第10回】テストを自動化する(VitestとPlaywrightで予約の通しを確かめる)
- 【Next.jsで作るオンライン予約サービス 第11回】Vercelに公開する(環境変数・DB接続・本番チェックで「公開したら動かない」を防ぐ)










コメント
コメント一覧 (7件)
[…] 予約サービスに「会員ログイン」を付けると、利用者は自分の予約履歴を見られるようになり、運営側は「誰の予約か」を確実に結びつけられます。一方で、ログインは作り方を間違えると、他人の予約が見えてしまうなど、情報漏えいに直結する機能です。前回のダブルブッキング防止(第4回)で予約の土台が固まったので、今回は会員ログインを付けます。 […]
[…] 【Next.jsで作るオンライン予約サービス 第4回】ダブルブッキングを防ぐ(P… […]
[…] 【Next.jsで作るオンライン予約サービス 第4回】ダブルブッキングを防ぐ(P… […]
[…] 【Next.jsで作るオンライン予約サービス 第4回】ダブルブッキングを防ぐ(P… […]
[…] 【Next.jsで作るオンライン予約サービス 第4回】ダブルブッキングを防ぐ(P… […]
[…] 【Next.jsで作るオンライン予約サービス 第4回】ダブルブッキングを防ぐ(P… […]
[…] 【Next.jsで作るオンライン予約サービス 第4回】ダブルブッキングを防ぐ(P… […]