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

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

Часто задаваемые вопросы App Hosting

Поддерживает ли App Hosting другие фреймворки, помимо Next.js и Angular?

App Hosting предоставляет преднастроенную поддержку сборки и развёртывания для Next.js и Angular, где мы стремимся понять эти фреймворки и интерпретировать их собственные конфигурации. Для ряда других фреймворков сообщество разработчиков поддерживает адаптеры App Hosting . Кроме того, App Hosting попытается выполнить сборку любого приложения Node.js со скриптом сборки и запуска, но не может гарантировать её успешный результат. См. раздел Интеграция фреймворков .

Какие регионы поддерживает Firebase App Hosting ?

Регионы App Hosting , вероятно, со временем расширятся. Актуальную информацию см. в разделе «Места App Hosting .

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

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

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

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

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

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

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

Чтобы решить эту проблему, удалите пользовательский домен из бэкэнда App Hosting и добавьте его заново. Обновлённый интерфейс консоли предоставит три новые записи: записи A и TXT для домена, а также CNAME для поддомена ACME Challenge (для сертификатов). Используйте эти записи вместо предыдущей 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 и устранение неполадок

• CDN App Hosting может включать в свои ключи кэша только определённый набор заголовков запросов. Этот список включает RSC , Next-Router-State-Tree , Next-Router-Prefetch , Next-Router-Segment-Prefetch и Next-Url от NextJS, а также стандартные заголовки 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 CDN. Если ответ содержит заголовок Vary со значением, не указанным здесь, наш CDN не будет его кэшировать.
• Некэшированные статические файлы обслуживаются из Cloud Run ; в более поздней версии они будут храниться и обслуживаться из источника App Hosting для лучшей производительности.
• Консоль Firebase может периодически показывать ошибку «сборка не найдена и недопустима» при создании бэкэнда.
• Все бэкенды в одном проекте используют общую учётную запись GitHub org/account. Их можно подключить к разным репозиториям в рамках этой учётной записи org/account. Чтобы создать бэкенды, подключенные к разным учётным записям GitHub, поместите их в отдельные проекты.

Ограничения и устранение неполадок в приложении Angular

Хотя поддержка App Hosting для Angular активно развивается и расширяется, она имеет следующие ограничения:

• I18n : Хотя основные функции I18n работают, прямой переход на страницы SSR может привести к ошибкам.
• Локализация : Создание версий для разных локалей не поддерживается.
• Конструкторы : в настоящее время поддерживается только конструктор приложений.
• Окружения и инструменты монорепозитория : проекты Angular, рассчитанные на более чем одно целевое приложение, не будут работать. Для более полной поддержки монорепозитория используйте Nx.

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

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