トラブルシューティング | hanamii ドキュメント

ガイド

ドキュメント

トラブルシューティング

デプロイ失敗の典型パターンと対処法、ログの見方、AI アシスタントを使った修正の流れ。

デプロイがうまくいかないときの調べ方と、代表的なエラーの対処をまとめました。

まずエラーの種類を確認する

デプロイに失敗すると、エラー画面またはプロジェクト詳細にエラーの種類が表示されます。

エラー表示	意味	主な対処
プロジェクト構成エラー	必須ファイルの不足など、プロジェクトの構成に問題がある	`package.json` と `scripts.start` の有無を確認
ビルドエラー	ビルド実行中に失敗した	エラーメッセージを確認し、手元で `npm run build` が通るか確認
AppRunデプロイエラー	ビルドは成功したが、アプリの起動確認に失敗した	起動コマンド・待受ポート・HTTP 応答を確認
ヘルスチェックに応答できませんでした	指定したヘルスチェックパスが応答しなかった	パスとポートの設定、アプリの起動を確認
サーバーエラー	hanamii 側で問題が発生した	しばらく待ってから再デプロイ。解消しない場合はお問い合わせ

エラー画面の 全エラーをAI用にコピー ボタンを使うと、エラー内容をまとめてコピーできます。ChatGPT や Claude などの AI アシスタントに貼り付けると、修正方法の提案を得られます。

ビルドが成功してもアプリの起動確認に失敗すると「AppRunデプロイエラー」または「AppRun起動タイムアウト」になります。エラー画面には検出できた事実（アプリの状態・待受ポートなど）と原因候補が表示されます。

チェックポイント:

起動コマンド: package.json の scripts.start でアプリが起動するか（手元で npm run start を確認）
待受ポート: アプリが指定されたポートで HTTP を待ち受けているか
起動時エラー: 必要な環境変数が未設定で起動時に落ちていないか → 環境変数の設定

代表的な検証エラーと対処は ZIP からデプロイするを参照してください。

プロジェクト詳細のログタブで ログを取得 を押すと、直近 15 分のログがリアルタイム表示されます。エラー（赤）・警告（黄）が色分けされるので、アプリの実行時エラーはここで確認します。

プロジェクト詳細のログ表示

バージョン情報 タブで、各バージョンの状態（稼働中 / エラー）と作成日時を確認できます。エラーになったバージョンは 確認する からエラー詳細を開けます。

バージョン情報タブ。各バージョンの状態と「切り替え」ボタン

バージョン情報 タブで戻したいバージョンの 切り替え を押すと、そのバージョンへ即座に切り替えられます。環境変数もそのバージョン作成時の状態に戻る点に注意してください。

お問い合わせからご連絡ください。プロジェクト名と発生時刻、エラー画面の内容を添えていただくとスムーズです。