よくある質問とトラブルシューティング

このページでは、App Hosting に関するよくある質問（FAQ）の回答を紹介します。

App Hosting よくある質問

一般的な App Hosting の制限事項とトラブルシューティング

  • Cloud Run インフラストラクチャの問題により、us-central1 などの一部のリージョンで、リソースの作成または更新が想定よりも遅くなることがあります。特定のリージョンでデプロイ レイテンシが問題になる場合は、別のリージョンにデプロイすることをおすすめします。
  • App Hosting の CDN は、特定のセットのリクエスト ヘッダーのみをキャッシュキーに含めることができます。このリストには、NextJS の RSC、Next-Router-State-Tree、Next-Router-Prefetch、Next-Router-Segment-Prefetch、Next-Url ヘッダーと、Cloud CDN の標準の Accept、Accept-Encoding、Access-Control-Request-Headers、Access-Control-Request-Method、Origin、Sec-Fetch-Dest、Sec-Fetch-Mode、Sec-Fetch-Site、X-Goog-Allowed-Resources、X-Origin が含まれます。レスポンスにここに記載されていない値の Vary ヘッダーが含まれている場合、CDN はそれをキャッシュに保存しません。
  • キャッシュに保存されていない静的ファイルは Cloud Run から配信されます。後のリリースでは、パフォーマンスを向上させるため、App Hosting オリジンに保存されて配信されるようになります。
  • Firebase コンソールで、バックエンドの作成時に「ビルドが見つからず、無効です」というエラーが断続的に表示されることがあります。
  • 同じプロジェクト内のすべてのバックエンドは、GitHub 組織/アカウントを共有します。これらのバックエンドは、その組織/アカウントの異なるリポジトリに接続できます。異なる GitHub アカウントに接続するバックエンドを作成するには、それらを別々のプロジェクトに配置します。

Angular アプリの制限事項とトラブルシューティング

Angular の App Hosting サポートは積極的に開発され、拡大されていますが、次のような制限があります。

  • I18n: コア I18n 機能は動作しますが、SSR ページに直接移動するとエラーが発生することがあります。
  • ローカライズ: 異なるロケール用のバージョンのビルドはサポートされていません。
  • ビルダー: 現在サポートされているのはアプリケーション ビルダーのみです。
  • 環境と Monorepo ツール: 複数のアプリケーション ターゲットを持つ Angular プロジェクトは失敗します。より完全な monorepo サポートについては、Nx を使用してください。

Angular SSR での HTTP 400 エラーとプロキシの信頼

Firebase App Hosting にデプロイされた Angular アプリケーションで HTTP 400（Bad Request）エラー、ホスト検証ブロッカー、プロキシ信頼の失敗が発生した場合は、Angular のバージョンに応じた推奨ソリューションに従ってください。

  • Angular v19、v20、v21: HTTP 400 エラーを解決するには、次の 2 つの方法があります。
    • 依存関係をアップグレードする: npm update @angular/core @angular/ssr を実行して、現在の Angular バージョンの最新のパッチリリースをインストールします。
    • 手動構成: サーバー構成で trustProxyHeaders: true を設定して、コードレベルの構成フォールバックを適用します（Angular ドキュメントの信頼できるプロキシ ヘッダーの構成を参照）。
  • Angular v22: 新しいバックエンドでの最初のビルドで 400 エラーが返されることがあります。この問題を解決するには、2 回目のビルドを生成します。以降のビルドはすべて意図したとおりに動作します。

Next.js の制限事項とトラブルシューティング

  • デフォルトでは、images.unoptimized を明示的に false に設定するか、カスタムの画像ローダーを使用しない限り、App Hosting で組み込みの NextJS 画像最適化は無効になっています。Next.js での画像読み込みの最適化をご覧ください。
  • パーセント エンコードされた文字を含む URL パスは、Cloud Run によってデコードされます。これにより、Next.js の並列ルーティングなど、エンコードされた URL パスのみを想定している機能で問題が発生する可能性があります。
  • 現在、App Hosting は ミドルウェアを使用する NextJS アプリのキャッシュ保存を制限しています。キャッシュ ヒット率は時間の経過とともに改善されます。
  • パーセント エンコードされた文字を含む URL パスは、Cloud Run によってデコードされます。これにより、Next.js の並列ルーティングなど、エンコードされた URL パスのみを想定している機能で問題が発生する可能性があります。