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

公開：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など)の送信をクライアントに要求する際に使用されます。

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

Python研修一覧はこちら

目的に合うPython研修を一覧形式から探したい方は、ぜひご利用ください。

Python研修を比較する

Java研修一覧はこちら

目的に合うJava研修を一覧形式から探したい方は、ぜひご利用ください。

Java研修を比較する

PHP研修一覧はこちら

目的に合うPHP研修を一覧形式から探したい方は、ぜひご利用ください。

PHP研修を比較する

新入社員研修

目的に合う新入社員研修を一覧形式から探したい方は、ぜひご利用ください。

新入社員研修を比較する

全ての研修からも探したい方はこちら

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で確認・デバッグしておりますが、間違いやエラー、脆弱性などがある場合は、コメントよりご報告いただけますと幸いです。