500 Internal Server Errorレスポンスのモック

500 Internal Server Error

500ステータスコードはサーバー側で何かが問題になったことを意味します。4xxエラーとは異なり、クライアントは何も間違ったことをしていません。このモックは内部詳細を公開しない汎用的なエラー構造を生成します。

レスポンス構造

{
  "error": {
    "code": "INTERNAL_SERVER_ERROR",
    "message": "An unexpected error occurred. Please try again later.",
    "details": []
  }
}

セキュリティベストプラクティス

本番環境の500レスポンスでスタックトレース、データベースエラー、内部ファイルパスを公開しないでください。このモックは正しいパターンを示します：

• 汎用的でユーザーフレンドリーなメッセージ
• 機械可読なエラーコード
• 空のdetails配列（内部情報の漏洩なし）

相関ID

本番環境では、ユーザーがサポートに連絡する際に特定のエラーを参照でき、エンジニアが対応するログエントリを見つけられるように、requestIdまたはcorrelationIdフィールドを含めることが多いです：

{
  "error": {
    "code": "INTERNAL_SERVER_ERROR",
    "message": "An unexpected error occurred.",
    "requestId": "req_abc123def456"
  }
}

フロントエンドでの処理

500レスポンスを受信した場合：

1. フレンドリーなエラーメッセージを表示（「問題が発生しました」）
2. リトライボタンを提供
3. 自動リトライに指数バックオフを実装
4. モニタリングダッシュボード用にエラーをログ記録
5. 利用可能な場合はリクエストIDを表示