常見問題與疑難排解

本頁面提供 App Hosting 的常見問題 (FAQ) 解答。

App Hosting 常見問題

App Hosting 是否支援 Next.js 和 Angular 以外的架構？

App Hosting 為 Next.js 和 Angular 提供預先設定的建構和部署支援，我們致力於瞭解這些架構並解讀其原生設定。對於許多 其他架構，開發人員社群支援架構轉接程式 App Hosting。此外，對於任何含有建構和啟動指令碼的 Node.js 應用程式，App Hosting 會嘗試建構，但無法保證一定會成功。請參閱「架構整合」。

Firebase App Hosting 支援哪些地區？

App Hosting的適用區域可能會隨著時間擴大。如要瞭解最新消息，請參閱 App Hosting 地點。

除了 GitHub，我還能使用 GitLab 或其他 Git 供應商進行部署嗎？

目前無法，但我們已將支援其他供應商納入 App Hosting 的長期發展藍圖。

為什麼我在 Firebase 主控台使用者介面中找不到存放區？ 

如果在 Firebase 控制台中建立新後端時，選項清單未顯示您的存放區，請先選取「重新整理清單」。如果偏好的存放區仍無法使用，您可能需要使用「授予 GitHub 新存放區的存取權」選項新增存放區。

此外，您也可以使用 Firebase App Hosting GitHub 應用程式管理存放區。如要執行這項操作，請前往 GitHub 個人資料，然後依序選取「Settings」和「Applications」。在 Firebase App Hosting 應用程式的表格列中，按一下「設定」即可管理存放區。

為什麼我的網站在 Android 行動應用程式 WebView 中無法正常顯示？ 

如果應用程式在 2025 年第 3 季前，透過 Firebase 控制台設定了自訂網域，可能會發現網站無法在 Android WebView 中正常顯示。這是因為該期間使用的 CNAME 記錄與 Android WebView 不相容。

如要解決這個問題，請從後端移除自訂網域，然後重新新增。App Hosting 更新後的控制台 UI 會提供 3 項新記錄：網域的 A 記錄和 TXT 記錄，以及 ACME 驗證子網域的 CNAME 記錄 (適用於憑證)。請使用這些記錄取代先前的 CNAME 記錄。

如何變更與 App Hosting 專案相關聯的存放區？

目前無法變更存放區。不過，您可以在同一專案中建立與偏好存放區相關聯的新後端，或在其他專案中建立新後端。

如何為 App Hosting 網站設定標題？

標頭取決於架構。照常為架構執行任何作業。

是否有適用於 App Hosting 的本機開發模擬器？

可以，您可以使用 App Hosting 模擬器在本機測試應用程式，再進行部署。App Hosting 模擬器是 Firebase 本機模擬器套件的一部分。請參閱「在本機測試應用程式部署作業 」。

為什麼 App Hosting 中顯示錯誤，但 Cloud Build 卻沒有？

在這種情況下，錯誤可能來自 Cloud Run。請檢查推出狀態，確認是否已完成。

如何變更或移除已連結的 GitHub 帳戶？

如要移除連結的 GitHub 帳戶，請開啟 Developer Connect，確認已選取專案，然後刪除 firebase-app-hosting-github-oath 連線和以 apphosting-github-conn- 開頭的連線。在 Firebase 控制台中開啟 App Hosting 時，您現在應該可以設定新的 GitHub 連線。

如何為 App Hosting 網站設定 Cookie？

雖然 App Hosting 預覽版推出時無法使用，但 Set-Cookie HTTP 回應標頭現在已可正常運作。

一般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 或使用自訂 Image Loader，否則 App Hosting 會停用內建的 NextJS 圖片最佳化。請參閱「在 Next.js 中最佳化圖片載入作業」。
• 含有百分比編碼字元的網址路徑會由 Cloud Run 解碼。這可能會導致預期只有編碼網址路徑的功能發生問題，例如 Next.js 平行路徑。
• 目前 App Hosting 會限制使用中介軟體的 NextJS 應用程式快取。快取命中率應會隨時間提升。
• Cloud Run 會解碼含有百分比編碼字元的網址路徑。 這可能會導致預期只有編碼網址路徑的功能發生問題，例如 Next.js 平行路徑。