常见问题解答和问题排查

本页面提供了有关 App Hosting 的常见问题解答 (FAQ)。

App Hosting 常见问题解答

一般 App Hosting 限制和问题排查

  • 由于 Cloud Run 基础架构存在问题，在某些地区（例如 us-central1），创建或更新资源的速度可能会比预期慢。如果特定区域的部署延迟时间过长，Google 建议部署到其他区域。
  • 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 控制台可能会在后端创建时偶尔显示“build was not found and is invalid”（找不到 build，且 build 无效）错误。
  • 同一项目中的所有后端共享一个 GitHub 组织/账号。 它们可以连接到相应组织/账号下的不同代码库。 如需创建连接到不同 GitHub 账号的后端，请将它们放在不同的项目中。

Angular 应用限制和问题排查

虽然 App Hosting 对 Angular 的支持正在积极开发和扩展，但目前存在以下限制：

  • I18n：虽然核心 I18n 功能可以正常运行，但直接导航到 SSR 页面可能会导致错误。
  • 本地化：不支持为不同语言区域构建版本。
  • 构建器：目前仅支持应用构建器。
  • 环境和 Monorepo 工具：具有多个应用目标的 Angular 项目将会失败。如需更完善的 monorepo 支持，请使用 Nx。

Angular SSR 中的 HTTP 400 错误和代理信任

如果部署在 Firebase App Hosting 上的 Angular 应用遇到 HTTP 400（错误请求）错误、主机验证阻塞或代理信任失败，请按照建议的解决方案操作，具体取决于您的 Angular 版本：

  • Angular v19、v20 和 v21：您可以通过以下两种方式解决这些 HTTP 400 错误：
    • 升级依赖项：运行 npm update @angular/core @angular/ssr 以安装当前 Angular 版本的最新补丁版本。
    • 手动配置：通过在服务器配置中设置 trustProxyHeaders: true 来应用代码级配置回退（请参阅 Angular 文档中的配置可信代理标头）。
  • Angular v22：基于新后端构建的第一个版本可能会返回 400 错误。 如需解决此问题，请生成第二个 build。所有后续 build 都应按预期运行。

Next.js 限制和问题排查