意味
サーバーが予期しない状態に陥り、リクエストを完了できませんでした。サーバー側エラー全般を表す汎用コードです。
よくある原因
- アプリケーションコードの未処理の例外やバグ
- 誤った .htaccess や環境変数の欠落などの設定ミス
- より適切なステータスに対応付けられていないデータベースや依存先の障害
対処法
クライアント・閲覧者の場合
後で再試行します。続く場合は、発生時刻とレスポンスのリクエスト ID を添えて報告します。
サイトや API の運営者の場合
アプリケーションとサーバーのエラーログを確認して例外を直し、原因がわかっている場合はより具体的なコード(502、503、504)を返します。
レスポンス例
HTTP/1.1
HTTP/1.1 500 Internal Server Error
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Internal Server Error",
"status": 500,
"detail": "Something went wrong. Request id: 01J9Z6Q4K2."
} 仕様
よくある質問
› 500 の原因を見つけるには?
リクエスト時刻のサーバーやアプリのエラーログでスタックトレースを確認します。デバッグモードは開発環境でだけ有効にします。
› .htaccess ファイルが 500 の原因になる?
なります。.htaccess の構文エラーや未知のディレクティブで Apache は 500 を返します。