Часто задаваемые вопросы и устранение неполадок

На этой странице собраны ответы на часто задаваемые вопросы о App Hosting.

Часто задаваемые вопросы (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 locations.

Можно ли использовать GitLab или другие поставщики Git, кроме GitHub, для развертывания?

В настоящее время это невозможно, но в долгосрочных планах развития App Hosting предусмотрена поддержка других поставщиков.

Почему я не вижу свое хранилище в консоли Firebase?

Если при создании нового бэкенда в консоли Firebase вашего хранилища нет в списке, нажмите Обновить список. Если нужное хранилище по-прежнему недоступно, возможно, вам нужно добавить его, используя параметр Grant access to a new repository in GitHub (Предоставить доступ к новому хранилищу в GitHub).

Кроме того, вы можете управлять хранилищами с помощью Firebase App Hosting приложения GitHub. Для этого откройте профиль GitHub и выберите Settings (Настройки), а затем Applications (Приложения). В строке таблицы для приложения Firebase App Hosting нажмите Configure (Настроить), чтобы управлять хранилищами.

Почему мой сайт некорректно отображается в WebView мобильного приложения Android?

Если вы настроили собственный домен в консоли Firebase до III квартала 2025 года, сайт может некорректно отображаться в Android WebView. Это связано с тем, что записи CNAME, использовавшиеся в этот период, несовместимы с Android WebView.

Чтобы устранить эту проблему, удалите собственный домен из серверной части App Hosting и добавьте его снова. В обновленном интерфейсе консоли доступны три новые записи: запись A и запись TXT для домена, а также запись CNAME для субдомена, используемого для дополнительной проверки ACME для сертификатов. Используйте эти записи вместо предыдущей записи CNAME.

Как изменить хранилище, связанное с моим проектом App Hosting?

В консоли Firebase откройте серверную часть App Hosting и выберите Settings > Deployment (Настройки > Развертывание). В разделе Хранилище GitHub можно отключить текущее хранилище или выбрать другое, подключенное к проекту.

Как настроить заголовки для сайта на платформе App Hosting?

Заголовки зависят от фреймворка. Настройте заголовки в соответствии с документацией фреймворка.

Есть ли эмулятор для локальной разработки с помощью App Hosting?

Да, вы можете протестировать приложение локально перед развертыванием App Hosting, используя эмулятор App Hosting, который входит в Firebase Local Emulator Suite. Подробнее о том, как протестировать развертывание приложения на локальном устройстве…

Почему я вижу ошибки в App Hosting, но не в Cloud Build?

Ошибка может быть связана с Cloud Run. Проверьте статус внедрения.

Как изменить или удалить связанный аккаунт GitHub?

Чтобы удалить связанный аккаунт GitHub, откройте Developer Connect, убедитесь, что выбран нужный проект, и удалите подключение firebase-app-hosting-github-oauth и подключение, название которого начинается с apphosting-github-conn-. Откройте App Hosting в консоли Firebase. Теперь вы можете настроить новое подключение к GitHub.

Как настроить файлы cookie для сайта App Hosting?

Хотя заголовок HTTP-ответа Set-Cookie не был доступен при запуске предварительной версии App Hosting, теперь он работает правильно.

Общие ограничения и устранение неполадок в App Hosting

• Из-за проблемы в инфраструктуре Cloud Run создание и обновление ресурсов в некоторых регионах, например us-central1, может выполняться медленнее, чем обычно. Если задержка развертывания является проблемой в определенном регионе, Google рекомендует выполнить развертывание в другом регионе.

• Сеть доставки контента для App Hosting может включать в ключи кеша только определенный набор заголовков запросов. Вот что включено в этот список:

  • Заголовки Next.js: 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 может приводить к ошибкам.
• Локализация. Создание версий для разных регионов не поддерживается.
• Конструкторы. В настоящее время поддерживается только конструктор приложений.
• Среды и инструменты монорепозитория. Проекты Angular, у которых больше одной цели приложения, не будут работать. Для более полной поддержки монорепозиториев используйте Nx.

Ошибки HTTP 400 и доверие к прокси-серверу в Angular SSR

Если в приложении Angular, развернутом на платформе Firebase App Hosting, возникают ошибки HTTP 400 (недопустимый запрос), блокировки проверки хоста или сбои доверия прокси-сервера, воспользуйтесь решением, рекомендованным для вашей версии Angular:

• Angular v19, v20 и v21. Устранить ошибки HTTP 400 можно двумя способами:
  • Обновите зависимости. Для этого выполните команду npm update @angular/core @angular/ssr, чтобы установить последнее исправление для текущей версии Angular.
  • Настройка вручную. Примените резервную конфигурацию на уровне кода, задав trustProxyHeaders: true в конфигурации сервера (см. раздел Настройка доверенных заголовков прокси-сервера в документации Angular).
• Angular v22. Первая сборка на новом бэкенде может возвращать ошибки 400. Чтобы устранить проблему, создайте вторую сборку. Все последующие сборки должны работать правильно.

Ограничения и устранение неполадок Next.js

• По умолчанию встроенная оптимизация изображений NextJS отключена в App Hosting, если вы не установили для images.unoptimized значение false или не используете собственный загрузчик изображений. Подробнее об оптимизации загрузки изображений в Next.js…
• По умолчанию Next.js записывает кешированные страницы и данные в файловую систему, что учитывается в памяти каждого обслуживающего экземпляра на App Hosting. Если экземпляры перезапускаются с ошибками Memory limit exceeded, ознакомьтесь с разделом Настройка кеширования сервера в Next.js.
• В настоящее время App Hosting ограничивает кеширование для приложений NextJS, использующих промежуточное ПО. Со временем коэффициент совпадений в кеше должен увеличиться.
• Пути URL, содержащие символы с кодировкой в формате URL, декодируются Cloud Run. Это может привести к проблемам с функциями, которые ожидают только закодированные пути URL, например с параллельной маршрутизацией Next.js.