Эта страница переведена с помощью Cloud Translation API.

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

На этой странице представлены ответы на часто задаваемые вопросы (FAQ) о 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 .

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

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

Почему я не могу найти свой репозиторий в пользовательском интерфейсе консоли Firebase ?

Если ваш репозиторий не отображается в списке вариантов при создании нового бэкэнда в консоли Firebase , сначала попробуйте выбрать «Обновить список» . Если нужный репозиторий по-прежнему недоступен, возможно, вам потребуется добавить его, используя опцию «Предоставить доступ к новому репозиторию» в GitHub .

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

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

Приложения, в которых до третьего квартала 2025 года был настроен пользовательский домен с помощью консоли Firebase могут столкнуться с некорректным отображением сайта в Android WebView. Это происходит из-за того, что записи CNAME, использовавшиеся в тот период, были несовместимы с Android WebView.

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

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

В настоящее время изменить репозиторий невозможно. Однако вы можете создать новый бэкенд, связанный с выбранным репозиторием, в рамках того же проекта или создать новый бэкенд в отдельном проекте.

Как мне настроить заголовки для сайта, 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-oath а также соединение, начинающееся с apphosting-github-conn- . После открытия App Hosting в консоли Firebase вы сможете настроить новое соединение с GitHub.

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

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

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

Из-за проблемы в инфраструктуре Cloud Run создание или обновление ресурсов может происходить медленнее, чем ожидалось, в некоторых регионах, например, в регионе us-central1 . Если задержка развертывания является проблемой в конкретном регионе, Google рекомендует развернуть приложение в другом регионе.
CDN App Hosting может включать в свои ключи кэширования только определенный набор заголовков запроса. Этот список включает заголовки 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 может привести к ошибкам.
Локализация : Создание версий для разных языковых версий не поддерживается.
Конструкторы : В настоящее время поддерживается только конструктор приложений.
Инструменты для работы с средами разработки и монорепозиториями : проекты Angular, имеющие более одного целевого приложения, будут давать сбой. Для более полной поддержки монорепозиториев используйте Nx.

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

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

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

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

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

Часто задаваемые вопросы и устранение неполадок Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.