> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# デプロイメントのトラブルシューティング

> 公開された Replit アプリを変更する前に、ログを使って公開の失敗、起動とヘルスチェックの失敗、502 レスポンス、プレビューとの違いを診断します。

[Replit Status](https://status.replit.com) を確認し、失敗が発生している段階（ビルド中、起動中、リクエストの処理中）を特定します。再試行する前に、失敗したデプロイメントのログを保存しておいてください。設定の詳細については、[公開のトラブルシューティング](/ja/build/troubleshooting)をご覧ください。

## ビルド中に公開が失敗する

1. **Publishing** と、失敗したデプロイメントのログを開きます。
2. 最後の「build failed」メッセージだけでなく、最初の対処可能なエラーを見つけます。
3. ビルドコマンド、依存関係のインストール、参照しているファイルパスを確認します。
4. 公開に必要な環境変数が設定されているか確認します。プレビューが動作していても、本番の設定が検証されたことにはなりません。
5. 特定した問題を修正して再度公開し、新しいログを比較します。

実行コマンドがない場合は、公開設定を確認し、意図したコマンドを保存してから再試行してください。変更のないビルドを繰り返し再公開しないでください。

## ビルドは成功するが、起動またはヘルスチェックが失敗する

実行コマンドが、終了してしまうビルドプロセスではなく、長時間稼働するサーバーを起動することを確認してください。Web サーバーの場合は、バインドアドレスとポート設定を確認します。`localhost` でのみ待ち受けるのではなく、外部からの接続を受け付ける必要があります。

明示的なポートマッピングを変更する前に、[ポート設定](/ja/build/troubleshooting)をお読みください。サーバーがリクエストの受け付けを開始する前に、本番シークレットの不足、データベースの障害、例外がないか、起動ログを確認します。

デプロイメントを通すために、認証やアプリケーションのチェックを無差別に削除しないでください。失敗しているルートや起動時の依存関係を診断してください。

## 公開済みアプリが 500 または 502 を返す

1. 1つのリクエストを再現し、その時刻と対象の URL を記録します。
2. その時刻前後のランタイムログで、例外、クラッシュ、再起動がないか調べます。
3. 必要なデータベースや外部 API に到達できるか確認します。
4. 失敗を、[モニタリング](/ja/features/publishing/monitoring-a-deployment)の CPU とメモリの使用状況と比較します。

500 や 502 は症状であり、特定の原因の証拠ではありません。[ネットワークとアプリエラー](/ja/help/networking-and-app-errors)をご覧ください。

`replit.app` の URL は動作するがカスタムドメインが失敗する場合は、[ドメインガイド](/ja/help/troubleshooting/domains)をご利用ください。サインインだけが失敗する場合は、[認証ガイド](/ja/help/troubleshooting/auth)をご利用ください。

## プレビューは動作するが、公開版は動作しない

公開版、ビルドコマンドと実行コマンド、本番シークレット、データベースの選択、認証設定を比較してください。ワークスペースのシークレットを更新しても、公開済みアプリが同じ値を使用していることにはなりません。

的を絞った本番設定の変更を行った後は、公開して再度テストしてください。古いバージョンを再デプロイする前に、現在のデータベーススキーマと互換性があるか確認してください。コードの再デプロイは、データベースのリストアではありません。

## ワークスペースのポリシーにより公開がブロックされる

「Public deployments are not allowed for this workspace」と表示された場合は、ワークスペース管理者に公開ポリシーの確認を依頼してください。コードやデータを個人のワークスペースに移してポリシーを回避しないでください。

## それでも失敗する場合

プロジェクトの URL、デプロイメントタイプ、失敗した段階、サニタイズ済みのビルドログまたはランタイムログ、失敗したリクエストの時刻を Support に送ってください。プレビューと公開済み URL で動作が異なるかどうかも記載してください。[サポートチェックリスト](/ja/help/troubleshooting/overview#サポートに連絡するタイミング)に従ってください。