常見問題與疑難排解

本頁面提供 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)：核心國際化功能可正常運作，但直接導覽至伺服器端算繪 (SSR) 頁面可能會導致錯誤。
  • 本地化：不支援為不同語言代碼建立版本。
  • 建構工具：目前僅支援應用程式建構工具。
  • 環境和 Monorepo 工具：如果 Angular 專案有多個應用程式目標，就會失敗。如要取得更完整的 Monorepo 支援，請使用 Nx。

Next.js 限制和疑難排解

  • 根據預設，除非您明確將 images.unoptimized 設為 false 或使用自訂 Image Loader，否則 App Hosting 會停用內建的 NextJS 圖片最佳化。請參閱「在 Next.js 中最佳化圖片載入作業」。
  • 含有百分比編碼字元的網址路徑會由 Cloud Run 解碼。這可能會導致預期只有編碼網址路徑的功能發生問題，例如 Next.js 平行路徑。
  • 目前 App Hosting 會使用中介軟體，限制 NextJS 應用程式的快取。快取命中率應會隨時間提高。
  • Cloud Run 會解碼含有百分比編碼字元的網址路徑。這可能會導致預期只有編碼網址路徑的功能發生問題，例如 Next.js 平行路徑。