- Day 57:データ削除 ― DELETE APIで指定したデータを安全に削除する
- 今日のゴール
- 削除処理の全体像を確認する
- DELETEとは何か
- 物理削除と論理削除の違いを考える
- APIの契約を先に決める
- 同じDELETEを2回送るとどうなるのか
- Day 56までの環境を確認する
- 削除前に学習用データを用意する
- Prismaの削除サービスを追加する
- 既存の詳細APIへDELETEを追加する
- まずはAPI単体で確認する
- 削除ボタン付き一覧を作る
- 削除確認ページを作る
- router.refresh()の役割を理解する
- 関連データがある場合の削除を理解する
- 複数の変更を伴う削除はどう考えるのか
- 通信失敗でも、削除済みの可能性があります
- 確認ダイアログとセキュリティを混同しない
- 削除後のIDについて考える
- 動作確認表
- よくあるつまずきと確認方法
- 型チェックと本番ビルドを確認する
- 自力で取り組む練習問題
- Day 57のチェックリスト
- まとめ
Day 57:データ削除 ― DELETE APIで指定したデータを安全に削除する
Day 57では、Next.jsのRoute HandlersとPrismaを使い、保存済みのユーザーを削除します。これまでの作成・取得・更新に削除が加わることで、CRUDの基本操作がひととおりそろいます。
ただし、削除は「ボタンを押したらDBの行を消す」だけではありません。対象の特定、操作前の確認、関連データへの影響、失敗時の案内、削除後の画面更新まで考えることが重要です。
今回は、Day 56までのユーザー管理アプリへDELETE APIと削除ボタン付き一覧を追加します。
今日のゴール
| 項目 | 今回実装すること |
|---|---|
| DELETE API | DELETE /api/users/[id] |
| 対象の指定 | URLのユーザーIDを使います |
| DB操作 | Prismaのdelete()を使います |
| 入力検証 | IDの形式と範囲を確認します |
| 未存在 | 削除対象がなければ404を返します |
| 関連データ | 外部キー制約による削除拒否を扱います |
| 画面 | ユーザーごとに削除ボタンを表示します |
| 操作確認 | 削除前に対象名とIDを確認します |
| 一覧更新 | 成功後にServer Componentを再取得します |
今回も、ダミーデータを扱うローカル学習専用の実装です。 認証をまだ実装していないため、APIは開発環境以外では削除を拒否します。
削除処理の全体像を確認する
今回の画面とAPIは、次の順番で動きます。
ユーザー一覧を表示する
↓
対象ユーザーの削除ボタンを押す
↓
名前とIDを確認する
↓
DELETE /api/users/[id] を送る
↓
APIがIDを検証する
↓
Prismaで指定した1件を削除する
↓
削除結果をJSONで返す
↓
画面に結果を表示する
↓
ユーザー一覧を再取得する
重要なのは、画面の一覧から消すことと、DBから削除することは別の処理だという点です。
今回の実装では、サーバーから削除成功の結果を受け取ってから、一覧を再取得します。
DELETEとは何か
DELETEは、指定したリソースの削除をサーバーへ依頼するHTTPメソッドです。今回は、URLでユーザーを指定します。DELETEの本文には一般的な意味が定義されていないため、今回のAPIにはリクエスト本文を持たせません。(🔗 developer.mozilla.org)
DELETE /api/users/7
↑
削除対象のユーザーID
GETやPATCHと比較すると、役割の違いが分かります。
| リクエスト | 今回の役割 |
|---|---|
GET /api/users/7 | IDが7のユーザーを取得します |
PATCH /api/users/7 | IDが7のユーザーを部分更新します |
DELETE /api/users/7 | IDが7のユーザーを削除します |
今回は、同じ詳細URLに対して、HTTPメソッドで処理を分けます。
Next.jsでは、同じroute.tsにGET、PUT、PATCH、DELETEなどを定義できます。(🔗 nextjs.org)
URLを開くだけでは削除しない
ブラウザーのアドレスバーでURLを開く操作と、DELETEリクエストを送る操作は別です。
今回の削除は、JavaScriptのfetch()で明示的にDELETEを指定して実行します。通常のHTMLフォームで直接指定できるメソッドでもありません。(🔗 developer.mozilla.org)
取得用のGETへ削除処理を混ぜないことを、今回の設計ルールにします。
物理削除と論理削除の違いを考える
今回実装するのは、ユーザーの行をDBから削除する「物理削除」です。
一方、行を残し、削除日時などで非表示扱いにする設計もあります。
| 方式 | 今回の説明上の意味 | 設計時に考えること |
|---|---|---|
| 物理削除 | DBから対象行を削除します | 関連データ、復元方法、保存要件 |
| 論理削除 | 行を残し、削除済み状態にします | 通常の一覧から除外する条件、復元、保管期限 |
この講座のDay 57では、論理削除の列は追加せず、物理削除だけを実装します。
削除ボタンに「元に戻せます」と書かない
今回のアプリには、削除後に復元する機能がありません。
そのため、確認メッセージでは「この画面からは元に戻せない」と案内します。
「バックアップから戻せるかもしれないこと」と「利用者がアプリ上で取り消せること」は、別の機能として考えます。
APIの契約を先に決める
今回のAPIは、次のルールにします。
- URLのIDで、削除するユーザーを1人指定します。
- リクエスト本文は使いません。
- 成功時は200とJSONを返します。
- 存在しないユーザーは404にします。
- 関連データの制約で削除できない場合は409にします。
- 削除対象のメールアドレスなどはレスポンスへ含めません。
- 開発環境以外では403にします。
成功時のレスポンス
{
"message": "ユーザーを削除しました。",
"deletedUserId": 7
}JSONJSONにはコメントを書けないため、JSONの例にはコメントを付けていません。
ステータスコードの使い分け
| ステータス | 今回の意味 |
|---|---|
200 | 削除できました |
400 | IDの形式や範囲が不正です |
403 | 開発環境以外なので拒否しました |
404 | 指定したユーザーが存在しません |
409 | 関連データの制約により削除できません |
500 | 予期しないサーバー側の失敗です |
DELETEの成功時には、結果を返す200のほか、本文を返さない204なども使えます。今回は結果をJSONで返すため、200を選びます。204を使う設計へ変更する場合は、レスポンス本文を返さず、画面側でもJSONを読まないようにします。(🔗 developer.mozilla.org)
同じDELETEを2回送るとどうなるのか
今回のAPIでは、最初の削除は200、その後に同じIDを削除すると404です。
1回目
ユーザーが存在する
↓
削除する
↓
200
2回目
ユーザーが存在しない
↓
削除対象がない
↓
404
レスポンスが違っても、べき等性とは矛盾しません
DELETEは、同じリクエストを繰り返したときの意図する結果が変わらない、べき等なメソッドです。
ここで重要なのは、毎回同じステータスを返すことではなく、同じ対象が削除された状態になることです。1回目が200、2回目が404でも、この考え方と矛盾しません。(🔗 developer.mozilla.org)
ただし、今回の画面では、通信に失敗したからといって自動で連続再送する仕組みは作りません。まず最新の一覧で状態を確認できるようにします。
Day 56までの環境を確認する
次の構成を引き継ぎます。
- Next.js App RouterとTypeScriptを使っています。
- Prisma 7系でSQLiteへ接続できています。
- Prisma Clientの生成先は
src/generated/prismaです。 src/lib/prisma.tsでPrisma Clientを共有しています。getUsers()でIDと名前を取得できます。- 詳細の
route.tsにGET、PUT、PATCHがあります。
今回はモデルの構造を変えないため、削除機能を追加するだけならMigrationは不要です。
また、前回までと同じく、cacheComponents: trueを有効にしていない構成を前提にします。
変更するファイル
src/
├── app/
│ ├── api/
│ │ └── users/
│ │ └── [id]/
│ │ └── route.ts ← DELETEを追加します
│ └── users/
│ └── delete-demo/
│ └── page.tsx ← 新規作成します
├── components/
│ └── UserDeleteList.tsx ← 新規作成します
├── lib/
│ └── prisma.ts ← 既存のものを使います
├── services/
│ └── user.service.ts ← 削除関数を追加します
└── types/
└── user.ts ← 既存のUserSummaryを使います
既存のPOST、GET、PUT、PATCHや、それぞれの確認画面は残します。
削除前に学習用データを用意する
誤操作の影響を抑えるため、削除専用のダミーユーザーを作ります。
Day 54の登録画面から、たとえば次の内容で登録します。
| 項目 | 入力例 |
|---|---|
| 名前 | 削除確認用ユーザー |
| メールアドレス | day57-delete@example.com |
同じメールアドレスをすでに使っている場合は、別のダミー値に変更します。
登録後、一覧APIや一覧画面でIDを確認します。
説明に出てくるIDを、そのまま実データのIDへ当てはめて削除しないことが大切です。
Prismaの削除サービスを追加する
まず、DB操作をサービスへ追加します。
src/services/user.service.tsへ追加するコード
既存の取得・作成・更新処理は削除しません。既存のprismaのimportを使います。
// 指定したユーザーを1件削除します
export async function deleteUser(
id: number,
): Promise<{ id: number }> {
// 別の呼び出し元から使う場合も、IDの範囲を守ります
if (
!Number.isSafeInteger(id) ||
id < 1 ||
id > 2_147_483_647
) {
throw new RangeError("ユーザーIDが正しくありません。");
}
return prisma.user.delete({
// 必ず主キーで対象を限定します
where: {
id,
},
// 呼び出し側へ返すのは、削除したIDだけです
select: {
id: true,
},
});
}TypeScriptPrismaのdelete()は、一意な条件で指定したレコードを削除します。今回は主キーのIDを使い、削除したレコードから必要なIDだけを返します。(🔗 prisma.io)
deleteMany()ではなくdelete()を使う理由
今回は「指定した1人を削除する」機能です。
複数件を対象にする削除処理ではなく、主キーで1件を指定するdelete()を使います。Prismaには複数件削除のdeleteMany()もありますが、今回の目的とは分けます。(🔗 prisma.io)
特に初心者の段階では、条件のない一括削除を、1件削除の代わりに使わないようにします。
先にGETしてから削除する必要はあるのか
今回はAPIの内部では、事前の存在確認をせずに直接削除します。
事前に取得できても、その直後に別の処理で削除される可能性は残ります。そのため、実際の削除結果を扱う設計にします。
Prismaでは、削除に必要な対象が見つからない場合にP2025、外部キー制約に違反した場合にP2003などの既知エラーを扱えます。(🔗 prisma.io)
画面で対象を確認することと、API内部で削除結果を正しく処理することは、どちらも必要です。
既存の詳細APIへDELETEを追加する
次に、HTTPリクエストの入口を作ります。
対象ファイルは、Day 56まで使っていた次のファイルです。
src/app/api/users/[id]/route.ts
サービスのimportへdeleteUserを追加する
既存のimportを、次のように変更します。
// 既存の取得・更新に、削除処理を追加します
import {
getUserById,
updateUser,
deleteUser,
} from "../../../../services/user.service";TypeScriptDay 56で使った次のimportも、そのまま残します。
// 既知のPrismaエラーを判定するために使います
import { Prisma } from "../../../../generated/prisma/client";TypeScript同じimportを二重に書かないようにします。
共通の定義を確認する
既存ファイルには、次の定義があることを確認します。
// JSONレスポンスの作成に使います
import { NextResponse } from "next/server";
// SQLiteのドライバーをNode.js環境で実行します
export const runtime = "nodejs";
// 動的ルートのパラメータ型です
type RouteContext = {
params: Promise<{
id: string;
}>;
};
// 既存のGET・PUT・PATCHでも使う共通関数です
function reply(body: unknown, status: number) {
return NextResponse.json(body, {
status,
headers: {
"Cache-Control": "no-store",
},
});
}TypeScriptすでに存在する場合は追加し直しません。
DELETE関数を追加する
同じファイルへ、次の関数を追加します。
// DELETE /api/users/[id] を処理します
export async function DELETE(
_request: Request,
context: RouteContext,
) {
// 認証未実装のため、開発環境だけで削除を許可します
if (process.env.NODE_ENV !== "development") {
return reply(
{
message: "この削除APIはローカル学習用です。",
},
403,
);
}
// URLから対象のIDを読み取ります
const { id: rawId } = await context.params;
// 先頭ゼロなしの、正の整数表記だけを受け付けます
if (!/^[1-9]\d{0,9}$/.test(rawId)) {
return reply(
{
message: "ユーザーIDの形式が正しくありません。",
},
400,
);
}
const id = Number(rawId);
// 今回のAPIで許可する範囲を確認します
if (!Number.isSafeInteger(id) || id > 2_147_483_647) {
return reply(
{
message: "ユーザーIDが許可範囲を超えています。",
},
400,
);
}
try {
const deletedUser = await deleteUser(id);
return reply(
{
message: "ユーザーを削除しました。",
deletedUserId: deletedUser.id,
},
200,
);
} catch (error) {
if (
error instanceof Prisma.PrismaClientKnownRequestError
) {
// すでに削除済み、または存在しないユーザーです
if (error.code === "P2025") {
return reply(
{
message: "削除対象のユーザーが見つかりません。",
},
404,
);
}
// 関連データの外部キー制約により削除できません
if (error.code === "P2003") {
return reply(
{
message:
"関連するデータがあるため、このユーザーは削除できません。",
},
409,
);
}
}
// 接続先や個人情報を、そのまま公開しません
console.error("ユーザー削除処理に失敗しました。");
return reply(
{
message: "削除できませんでした。時間をおいてお試しください。",
},
500,
);
}
}TypeScriptRoute Handlerの動的パラメータは、context.paramsをawaitして取得します。既存のGETやPATCHと同じ考え方です。(🔗 nextjs.org)
今回はJSON本文を読み取らない
削除対象はURLのIDで指定しているため、次の処理は不要です。
request.json()。- リクエスト本文の
nameやemailの検証。 - JSONを送るための
Content-Type指定。
DELETEリクエスト本文の意味に依存しない構成にすることで、今回のAPIは「どのIDを削除するか」に集中できます。(🔗 developer.mozilla.org)
まずはAPI単体で確認する
開発サーバーを起動します。
# 開発環境で起動します<br>npm run devBash一覧を取得し、削除確認用ユーザーのIDを確認します。
# 削除対象のIDと名前を確認します
curl -i "http://localhost:3000/api/users"Bash次は、削除専用ユーザーのIDが7だった場合の例です。実際に確認したIDへ変更してから実行します。
# IDが7の「削除確認用ユーザー」を削除する例です
curl -i \
-X DELETE \
"http://localhost:3000/api/users/7"Bash成功時は200とJSONが返ります。
削除後にGETで確認する
# 同じIDを取得し、404になることを確認します
curl -i "http://localhost:3000/api/users/7"Bashさらに、同じDELETEをもう一度送ると、今回のAPIでは404になります。
# すでに削除済みなので、404を期待します
curl -i \
-X DELETE \
"http://localhost:3000/api/users/7"BashAPI単体で確認できると、後から画面に問題が出ても、API側か表示側かを切り分けやすくなります。
削除ボタン付き一覧を作る
ここから、一覧の各ユーザーへ削除ボタンを付けます。
今回は、Server Componentで一覧を取得し、その結果を操作用のClient Componentへ渡します。
Server Component
getUsers()で一覧取得
↓
Client Component
削除ボタンを表示
↓
DELETE API
↓
成功後にrouter.refresh()
Client ComponentへDB接続処理を持ち込まず、表示と操作だけを担当させます。
src/components/UserDeleteList.tsx
"use client";
// 通信状態と画面更新状態を管理します
import { useRef, useState, useTransition } from "react";
import { useRouter } from "next/navigation";
// Day 55で作った、公開項目だけの型を使います
import type { UserSummary } from "../types/user";
type UserDeleteListProps = {
users: UserSummary[];
};
// APIのメッセージだけを安全に読み取ります
function readMessage(value: unknown): string | null {
if (
typeof value === "object" &&
value !== null &&
"message" in value &&
typeof value.message === "string"
) {
return value.message;
}
return null;
}
// 成功レスポンスに、対象の削除IDが含まれるか確認します
function isExpectedDeleteResult(
value: unknown,
expectedId: number,
): boolean {
return (
typeof value === "object" &&
value !== null &&
"deletedUserId" in value &&
value.deletedUserId === expectedId
);
}
export default function UserDeleteList({
users,
}: UserDeleteListProps) {
const router = useRouter();
// 削除通信中のユーザーIDです
const [deletingId, setDeletingId] = useState<number | null>(
null,
);
const [successMessage, setSuccessMessage] = useState("");
const [errorMessage, setErrorMessage] = useState("");
// router.refreshに伴う画面更新中の状態です
const [isRefreshing, startTransition] = useTransition();
// 再描画前の連続実行も抑えます
const deletingRef = useRef(false);
const isBusy = deletingId !== null || isRefreshing;
function refreshList() {
startTransition(() => {
router.refresh();
});
}
async function handleDelete(user: UserSummary) {
if (deletingRef.current || isRefreshing) {
return;
}
// 実際の送信前に、対象名とIDを確認します
const confirmed = window.confirm(
`「${user.name}」(ID: ${user.id})を削除しますか?\n` +
"この画面からは元に戻せません。",
);
if (!confirmed) {
return;
}
deletingRef.current = true;
setDeletingId(user.id);
setSuccessMessage("");
setErrorMessage("");
try {
const response = await fetch(
`/api/users/${user.id}`,
{
method: "DELETE",
},
);
// JSON以外の障害レスポンスも想定します
const payload: unknown = await response
.json()
.catch(() => null);
if (!response.ok) {
setErrorMessage(
readMessage(payload) ??
"ユーザーを削除できませんでした。",
);
// 別タブなどですでに削除されていた場合も一覧を更新します
if (response.status === 404) {
refreshList();
}
return;
}
if (!isExpectedDeleteResult(payload, user.id)) {
setErrorMessage(
"削除結果を確認できませんでした。一覧を更新して確認してください。",
);
refreshList();
return;
}
setSuccessMessage(
`「${user.name}」(ID: ${user.id})を削除しました。`,
);
// DB削除後の最新一覧をServer Componentから取得します
refreshList();
} catch {
// 通信失敗でも、削除自体は完了している可能性があります
setErrorMessage(
"通信結果を確認できませんでした。一覧を更新して状態を確認してください。",
);
} finally {
deletingRef.current = false;
setDeletingId(null);
}
}
return (
<section aria-labelledby="delete-list-heading">
<h2 id="delete-list-heading">削除するユーザーを選ぶ</h2>
<p>
対象を確認してから削除してください。
この画面には最大20件を表示します。
</p>
{successMessage && (
<p role="status">{successMessage}</p>
)}
{errorMessage && (
<p role="alert">{errorMessage}</p>
)}
{isRefreshing && (
<p role="status">一覧を更新しています。</p>
)}
<p>
<button
type="button"
onClick={refreshList}
disabled={isBusy}
>
一覧を更新する
</button>
</p>
{users.length === 0 ? (
<p>ユーザーはまだ登録されていません。</p>
) : (
<ul>
{users.map((user) => (
<li key={user.id}>
<span>
ID:{user.id} / 名前:{user.name}
</span>{" "}
<button
type="button"
onClick={() => handleDelete(user)}
disabled={isBusy}
aria-label={`${user.name}、ID ${user.id}を削除する`}
>
{deletingId === user.id
? "削除しています…"
: "削除する"}
</button>
</li>
))}
</ul>
)}
</section>
);
}TSX一覧をStateへコピーしていない理由
このコンポーネントは、受け取ったusersをそのまま表示します。
次のように、初期値だけをStateへコピーする構成にはしていません。
// 今回は、このような一覧の二重管理を行いません
// const [localUsers, setLocalUsers] = useState(users);TSX今回の画面では、DBから取得する一覧をServer Componentに任せ、Client Componentは削除中やメッセージの状態を持ちます。
これにより、「サーバーから届いた一覧」と「コピーしたローカル一覧」のどちらを正とするか、という管理を増やさずに済みます。
先に画面から消さない理由
今回は、サーバーの成功を確認してから一覧を更新します。
削除ボタンを押した瞬間に画面から消す「楽観的更新」も考えられますが、その場合は失敗時に表示を戻す設計が必要です。
Day 57では、まず成功・失敗の流れを明確にするため、先に消す実装は行いません。
response.okを確認する理由
404や409、500のレスポンスが返っても、それだけでは通常fetch()のcatchへ入りません。
HTTPの結果はresponse.okなどで確認し、通信自体の例外はcatchで扱います。(🔗 developer.mozilla.org)
削除確認ページを作る
src/app/users/delete-demo/page.tsx
// Metadata、リンク、一覧と取得サービスを読み込みます
import type { Metadata } from "next";
import Link from "next/link";
import UserDeleteList from "../../../components/UserDeleteList";
import { getUsers } from "../../../services/user.service";
// SQLiteのドライバーをNode.jsで使います
export const runtime = "nodejs";
// 今回は、アクセス時にDBから一覧を取得します
// cacheComponentsを有効にしていない構成を前提にします
export const dynamic = "force-dynamic";
export const metadata: Metadata = {
title: "ユーザー削除の確認",
description: "DELETE APIによる削除を学ぶページです。",
};
// 一覧取得はServer Componentで行います
export default async function UserDeleteDemoPage() {
const users = await getUsers(20);
return (
<section>
<h1>ユーザー削除の動作確認</h1>
<p>
ダミーデータを使うローカル学習用ページです。
必ず対象を確認してください。
</p>
<p>
<Link href="/users">
削除確認用のユーザーを登録する
</Link>
</p>
{/* DB接続ではなく、表示用の値だけを渡します */}
<UserDeleteList users={users} />
</section>
);
}TSX次のURLを開きます。
http://localhost:3000/users/delete-demo
画面での確認手順
- 削除確認用ユーザーを登録します。
- 削除確認ページを開きます。
- 対象の名前とIDを確認します。
- 削除ボタンを押します。
- 最初はキャンセルし、行が残ることを確認します。
- もう一度押し、対象を確認して削除します。
- 成功メッセージと一覧の変化を確認します。
- ブラウザーを再読み込みし、削除済みであることを確認します。
router.refresh()の役割を理解する
今回、DBから削除するのはDELETE APIです。
router.refresh()は、その後に現在のルートのServer Componentを再取得し、新しい内容を画面へ反映するために使います。既存のClient Componentの影響を受けていないStateなどは維持されます。(🔗 nextjs.org)
DELETE API
DBを変更する
router.refresh()
DB変更後の表示を再取得する
サーバーキャッシュの無効化とは別です
router.refresh()は、サーバー側のキャッシュをすべて無効にする命令ではありません。
今回は、動的ページから直接Prismaを呼び、一覧取得へ追加のサーバーキャッシュを設定していない構成です。将来キャッシュを追加したら、revalidatePathなどによる無効化も別途設計します。(🔗 nextjs.org)
また、Day 55のようにClient Componentがfetch()結果をStateで保持している別画面は、このページの更新だけでは自動的に同期されません。それぞれの取得方法に応じた更新処理が必要です。
関連データがある場合の削除を理解する
ユーザーに記事が関連付いている場合は、ユーザー1件を消すだけでも、ほかのデータへ影響します。
Day 51やDay 53で学んだ外部キーを思い出します。
users.id ← posts.user_id
削除ルールによって動きが変わる
| 関連の設定 | ユーザー削除時の動き | 注意点 |
|---|---|---|
Restrict | 参照する記事があれば削除を拒否します | 関連データを先に整理する必要があります |
Cascade | 関連記事も連動して削除します | ユーザーだけの削除ではなくなります |
SetNull | 関連記事の投稿者を未設定にします | 外部キーをNULL可能にする必要があります |
これらはPrismaのリレーションで指定でき、DBの参照整合性に対応します。Cascadeなら関連レコードも削除され、Restrictなら参照がある状態での削除が拒否されます。(🔗 prisma.io)
今回の409は、関連があるだけで必ず返るわけではありません
P2003を409に変換するのは、DBの外部キー制約が削除を拒否した場合です。
モデルに関連がなければ、その理由では拒否されません。また、関連があってもCascadeなら、関連行も削除される可能性があります。(🔗 prisma.io)
「関連があるか」だけでなく、「どの削除ルールになっているか」を確認することが重要です。
削除できないからという理由だけで、外部キー制約を外したり、Cascadeへ変更したりしないようにします。
複数の変更を伴う削除はどう考えるのか
今回のサービスは、ユーザー1件の削除だけを行います。
将来、次のような処理を加える場合は、どこまでをひとまとまりとして確定するか検討します。
- 記事の所有者を変更します。
- ユーザーを削除します。
- 削除操作の記録を保存します。
ただし、操作記録へ削除したユーザー自身への必須外部キーを付けると、削除方針と矛盾する場合もあります。トランザクションだけでなく、記録のデータ構造も設計対象です。
また、DBと外部ストレージ上の画像などを両方削除する処理は、DB内の操作だけとは別に失敗時の扱いを考えます。
今回は、関連データや外部ファイルを自動削除する処理までは追加しません。
通信失敗でも、削除済みの可能性があります
次の順番を考えます。
サーバーで削除に成功する
↓
レスポンスを返す途中で通信が切れる
↓
ブラウザーでは結果を確認できない
この場合、画面で通信エラーになっても、ユーザーはすでに削除されているかもしれません。
そのため、今回のメッセージは「削除されませんでした」と断定せず、一覧更新を案内しています。
404になったら一覧も見直す
別タブなどで、すでに削除された対象を操作する場合もあります。
今回の画面では、DELETEが404を返した場合にも一覧を再取得し、古い表示を残し続けないようにしています。
404を削除成功と同じメッセージへ置き換えるかはAPI設計によりますが、今回は「今回のリクエストで削除した」とは案内せず、対象が見つからなかったことを伝えます。
確認ダイアログとセキュリティを混同しない
今回のwindow.confirm()は、操作間違いを減らすための確認です。
確認ボタンを押したことは、削除権限の証明にはなりません。
APIを直接呼び出せば、この画面の確認を通らずにリクエストを送れます。
公開するAPIでは、各エンドポイントで認証・認可を実施し、対象ユーザーを削除してよいか判断する必要があります。(🔗 cheatsheetseries.owasp.org)
本人確認と対象確認を分ける
| 確認 | 問い |
|---|---|
| 入力検証 | IDは正しい形式ですか |
| 存在確認 | 対象ユーザーは存在しますか |
| 認証 | 操作しているのは誰ですか |
| 認可 | その人は、この対象を削除できますか |
| 操作確認 | 利用者は、この対象を本当に削除する意図がありますか |
今回の実装は、ID検証、DBの削除結果の処理、画面での操作確認を扱っています。
認証・認可は未実装なので、開発環境だけに制限しています。
公開前に考える追加ルール
ユーザー管理機能なら、たとえば次の要件も考えられます。
- 一般利用者は他人を削除できません。
- 管理者でも、最後の管理者を削除できません。
- 本人の退会には再認証を求めます。
- 削除後のセッションを無効化します。
- 関連データや保管情報の扱いを明確にします。
これらは今回のコードに自動で含まれる機能ではありません。アプリの要件として追加します。
Cookie認証を使う場合
状態を変更するAPIとして、認証・認可に加え、利用構成に適したCSRF対策なども検討します。CORSやHTTPメソッドを指定したことだけで、APIの保護が完成するわけではありません。(🔗 cheatsheetseries.owasp.org)
二重送信防止の限界
今回のボタン無効化やuseRefは、その画面からの連続操作を抑えるためのものです。
別タブや直接のAPI呼び出しも含め、サーバー側で正しく対象と権限を判断する必要があります。
最後に覚えておきたい原則
画面の確認は誤操作対策、サーバーの認可は不正操作対策です。片方で、もう片方を代用しないことが重要です。
削除後のIDについて考える
今回のユーザーIDは、行を識別するための値です。
たとえば、IDが次のように見えても、問題ではありません。
1、2、5、8
削除した行の分だけ番号が飛んでいても、残ったユーザーを1から振り直す処理は作りません。
IDを書き換えると、関連データやURLなどへ影響するためです。画面上の連番が必要なら、「表示用の順番」と「DBの主キー」を別に考えます。
動作確認表
| 確認内容 | 操作 | 期待する結果 |
|---|---|---|
| 通常削除 | 作成した専用ユーザーを削除 | 200、一覧から消えます |
| キャンセル | 確認ダイアログで中止 | リクエストを送りません |
| 削除後の取得 | 同じIDをGET | 404 |
| 同じ削除の再実行 | 同じIDをDELETE | 今回のAPIでは404 |
| IDが文字列 | /api/users/abc | 400 |
| IDが0 | /api/users/0 | 400 |
| 先頭ゼロ | /api/users/01 | 今回の仕様では400 |
| 範囲外ID | /api/users/2147483648 | 400 |
| 関連制約 | Restrictで参照される対象を削除 | 制約違反がP2003なら409 |
| 通信失敗 | 開発サーバー停止などで確認 | エラー案内と再確認手段 |
| 既存機能 | GET・POST・PUT・PATCHを確認 | これまでの機能も動きます |
| 本番起動 | DELETEを呼びます | 今回の制限で403 |
関連制約のテストは、その関係がある学習用DBで行います。409を試すためだけに、現在のモデルへ無計画に関連を追加する必要はありません。
よくあるつまずきと確認方法
| 症状 | 確認すること | 改善の方向 |
|---|---|---|
| 405になる | DELETEをexportしたか | 詳細側のroute.tsを確認します |
| 400になる | IDの形式 | 正の整数で指定します |
| 404になる | 対象が存在するか | 一覧GETで確認します |
| 409になる | 関連データと外部キー | 削除方針を確認します |
| 削除後も表示が残る | 一覧を再取得したか | router.refresh()と取得方法を確認します |
| 別画面だけ古い | Client側のState | その画面の取得処理を再実行します |
| JSON読み取りに失敗する | APIの成功形式 | 今回は200とJSONに統一します |
| 既存の更新が動かない | 既存コードを消していないか | GET・PUT・PATCHを残します |
| 本番起動で403になる | 開発専用の制限 | 今回は意図した動作です |
204へ変更した場合の注意
APIだけを204へ変更し、画面で引き続きJSON成功レスポンスを必須にすると、DB削除は成功したのに画面では結果不正になる可能性があります。
ステータスとレスポンス本文は、API側と画面側をセットで変更します。204は本文なしの成功を表します。(🔗 developer.mozilla.org)
型チェックと本番ビルドを確認する
開発環境で確認したら、型とビルドも確認します。
# 既存スキーマに対応するクライアントを生成します
npx prisma generate
# TypeScriptの整合性を確認します
npx tsc --noEmit
# 本番用にビルドします
npm run build
# 本番用サーバーを起動します
npm run startBash今回のDELETE APIは、本番起動では403を返します。
これは削除処理の不具合ではなく、実装した学習用制限によるものです。公開する場合は、制限を外す前に認証・認可などを実装します。
自力で取り組む練習問題
キャンセル時に通信が発生しないことを確認する
ブラウザーの開発者ツールでNetworkを開き、確認ダイアログをキャンセルします。
DELETEリクエストが送られていないことを確認します。
削除成功後の表示を改善する
成功メッセージへ、削除した名前とIDを表示します。
今回のコードで、その名前がAPIではなく画面で確認した値に由来することも説明します。別の人が直前に名前を変更した場合まで厳密に一致させたいなら、取得・確認・削除の競合をどう扱うかも検討します。
削除できない理由を案内する
関連データがある場合の409メッセージを改善します。
ただし、APIが返してよい範囲を決めずに、関連レコードの全情報を公開しないようにします。
論理削除の設計メモを書く
コードへすぐ追加するのではなく、次の問いへ答えます。
- 削除済み状態は、どの列で表しますか。
- 通常の一覧から、どう除外しますか。
- 同じメールアドレスの再登録を許可しますか。
- 削除済みユーザーはログインできますか。
- 誰が復元できますか。
- いつ物理削除しますか。
「削除フラグを追加する」だけでなく、取得・認証・一意制約・復元まで影響することを考える練習です。
Day 57のチェックリスト
- DELETE APIを既存の詳細ルートへ追加できました。
- URLのIDを検証してから削除できます。
- Prismaの
delete()で1件を削除できます。 - 存在しない対象を404として扱えます。
- 外部キー制約による削除拒否を区別できます。
- 削除前に名前とIDを確認できます。
- キャンセルしたら送信しない実装にできました。
- HTTPエラーと通信例外を区別できます。
- 削除成功後に一覧を再取得できます。
- 確認ダイアログと認可が別物だと理解しています。
- 物理削除と論理削除の違いを説明できます。
- GET・POST・PUT・PATCHも引き続き動作します。
まとめ
Day 57では、DELETE APIと削除ボタン付き一覧を作りました。URLのIDで対象を指定し、Prismaで削除し、結果に応じて成功・未存在・関連データによる拒否を返しました。
今回の中心は、「対象を確認する」「サーバーで対象を限定する」「実際の削除結果を扱う」「最新の一覧へ更新する」という流れです。
これで、作成・取得・更新・削除というCRUDの基本操作がそろいました。次はそれぞれの確認画面を整理し、入力・表示・エラー処理・権限を一貫した形へまとめることで、ひとつの使いやすいCRUDアプリへ発展させられます。
