アプリが起動しない: デプロイ、サイト、起動のエラー

​

アップロードとデプロイのエラー

​

INVALID_DEPENDENCY

​

KEEP_CALM

​

Web サイトが表示されない

• “The website took too long to respond”: Square Cloud はアプリケーションを見つけましたが、応答がありませんでした。
• “This site couldn’t be found”: そのアドレスには Web サイトが公開されていません。

1. サーバーがポート 80、ホスト 0.0.0.0 で待ち受けるようにします。localhost、127.0.0.1、またはほかのポート（3000、5173、8080 など）にバインドしたサーバーには到達できません。ランタイムは環境変数 PORT と HOST をこれらの値に設定しているので、それを読み取ってください。
   Node.js (Express)

   Python (Flask)

   app.listen(process.env.PORT || 3000, process.env.HOST || "0.0.0.0", () => {
     console.log("Server running");
   });
   
2. ログを開きます。アプリケーションがクラッシュしている、または依存関係のインストールやビルドの最中である場合、サイトはまだ応答できません。ログに表示されたエラーを修正するか、ビルドが終わるまで待ってください。
3. MEMORY がビルドに十分な余裕を与えているかを確認します。フレームワークのビルドで RAM が不足すると、アプリケーションは LACK_OF_RAM で停止します。

1. アドレスを確認します。正しいアドレスは、設定ファイルのサブドメインを使った https://<SUBDOMAIN>.squareweb.app です。
2. デプロイした直後であれば、アドレスが公開されるまで最大 1 分ほど待ちます。
3. SUBDOMAIN なしでデプロイしたアプリケーションは Web サイトではなく、後から Web サイトにすることもできません。SUBDOMAIN を設定して、新しいアプリケーションとしてもう一度アップロードしてください。
4. カスタムドメインの場合は、DNS がまだ反映中の可能性があります。ドメインがまだ反映されない理由を参照してください。

​

EADDRINUSE（ポートが既に使用中）

1. ポート 80、ホスト 0.0.0.0 で待ち受ける Web サーバーを 1 つだけ、一度だけ起動します。
2. コード内に .listen()（Node.js）や run()（Python/Flask/Django）の呼び出しが複数ないか検索し、重複を削除します。
3. listen の呼び出しが、複数回発火しうるコールバックの中ではなく、起動ファイルのトップレベルにあることを確認します。

​

“Cannot find module”（Node.js）と ModuleNotFoundError（Python）

• ライブラリが package.json の dependencies（Node.js）や requirements.txt/pyproject.toml（Python）に記載されていないため、ローカル環境では動作していても、プラットフォーム上ではインストールされません。
• Node.js で、パッケージが devDependencies にしかありません。アプリケーションは NODE_ENV=production で実行されるため、npm install は開発用の依存関係をスキップします。

1. 不足しているパッケージを、有効なバージョンとともに dependencies（または Python の依存関係ファイル）に追加します。
2. 依存関係ファイル自体がアップロードした zip に含まれていることを確認します。
3. アプリケーションを再起動します。Node.js の場合、依存関係は node_modules が存在しないときにしかインストールされません。ダッシュボードのファイルマネージャーで node_modules（アップロードしていれば package-lock.json も）を削除してから再起動すると、クリーンな状態から再インストールされます。

​

better-sqlite3 / ネイティブバインディングのエラー

1. better-sqlite3 を 12.5.0 以降に更新します（quick.db を使用している場合は 9.1.7 以降に更新してください）。
2. node_modules と package-lock.json を削除します。
3. アプリケーションを再起動し、現行のランタイムに対してネイティブバインディングを再ビルドするクリーンな再インストールを行います。

​

リソース制限による停止

​

時刻が数時間ずれる

​

関連ガイド

• 設定ファイル: すべてのフィールドと、それぞれで発生するエラー。
• 環境変数: 秘密情報を設定し、再起動して反映します。
• Discord ボットのエラーとデータベース接続エラー。

​

お問い合わせ