428エラー(Precondition Required)とは？意味をわかりやすく簡単に解説

公開：2025年10月31日更新：2025年10月31日

CodeCampが提供するDX人材育成が可能なプログラミングやITが学べる公開講座

428エラー(Precondition Required)とは
428エラーが発生する具体的なケース
Node.jsでの428エラーレスポンス実装

428エラー(Precondition Required)とは

428エラーはHTTPステータスコードの一つで、クライアントからのリクエストに必須の前提条件が含まれていない場合に、サーバーが返すエラーレスポンスを指します。このエラーはRFC 6585で定義されており、条件付きリクエストヘッダー(If-MatchやIf-None-Matchなど)の送信をクライアントに要求する際に使用されます。

サーバーは、複数のクライアントが同時にリソースを更新する際の競合状態を防ぐために、このステータスコードを利用します。

【PR】プログラミングや生成AIを無料で学べる「コードキャンプフリー」

428エラーが発生する具体的なケース

データベースやファイルシステムへの更新処理において、楽観的ロック機構を実装する場合に頻繁に発生します。例えば、ユーザーAとユーザーBが同じデータを同時に編集しようとした際、サーバーは最初のリクエストに対してETagと呼ばれる識別子を発行します。

次回のリクエストでは、このETagをIf-Matchヘッダーに含めることで、データが他のユーザーによって変更されていないことを確認できます。条件付きヘッダーが欠けている場合、サーバーは428エラーを返してクライアントに再試行を促します。

発生シーン	具体例
APIリソース更新時	条件付きヘッダーなしでPUT/PATCHを送信
ファイル編集時	バージョン情報を含まない上書き要求
在庫管理システム	在庫数の同時更新による不整合防止
Wiki編集時	編集競合を防ぐための条件チェック

Node.jsでの428エラーレスポンス実装

Node.jsのExpressフレームワークを使用して、428エラーを返すミドルウェアを実装する方法を紹介します。以下のコードでは、PUTリクエストに対してIf-Matchヘッダーの有無をチェックし、存在しない場合に428ステータスコードを返却します。

const express = require('express');
const app = express();

app.put('/api/resource/:id', (req, res) => {
  const ifMatch = req.headers['if-match'];
  
  if (!ifMatch) {
    return res.status(428).json({
      error: 'Precondition Required',
      message: 'If-Matchヘッダーが必要です'
    });
  }
  
  // リソース更新処理
  res.status(200).json({ success: true });
});

このコードでは、クライアントがリソースを更新する際に、必ずETag値を含むIf-Matchヘッダーを送信することを強制しています。ヘッダーが存在する場合は通常の更新処理を行い、存在しない場合はエラーメッセージとともに428ステータスを返すことで、データの整合性を保護できます。

※上記コンテンツの内容やソースコードはAIで確認・デバッグしておりますが、間違いやエラー、脆弱性などがある場合は、コメントよりご報告いただけますと幸いです。