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

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

App Hosting に関するよくある質問

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

  • 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 プロジェクトは失敗します。より完全なモノレポのサポートについては、Nx を使用してください。

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 パスのみを想定する機能で問題が発生する可能性があります。