Incident Guide

環境変数ミスで 500 エラーが出るときの見方

初学者、運用オンボーディング、API の初動対応に慣れたい人向け

API が 500 を返し、ログに接続エラーが出ているのに、原因がコードではなく設定にあるケースを切り分けるための入口です。

想定検索意図

環境変数 ミス 500 エラー api 起動しない

向いている人

初学者、運用オンボーディング、API の初動対応に慣れたい人向け

おすすめの進め方

症状を読む → 確認ポイントを押さえる → 関連シナリオで実際に手を動かす、の順で進めるのが最短です。

よくある症状

まずは自分の困り方がこのテーマに合っているかを確認します。

症状

health check が 500 になる

症状

ログに DB_HOST や接続先まわりのエラーが出る

症状

アプリ自体は起動しているように見えるが、内部で初期化に失敗している

最初に確認するポイント

まずログで missing / undefined / invalid のようなキーワードを探す
.env や設定ファイルのキー名を一文字ずつ確認する
修正後は再起動と health check まで確認する

このテーマで身につけたいこと

設定ミスを疑う順番
ログと .env を見比べる流れ
修正後の確認を省かない型

このテーマに合うシナリオ

読んで終わらせず、そのまま手を動かせるシナリオに絞っています。