Preguntas frecuentes y solución de problemas

En esta página, se proporcionan respuestas a las preguntas frecuentes sobre App Hosting.

App Hosting Preguntas frecuentes

¿App Hosting admite frameworks que no sean Next.js y Angular?

App Hosting proporciona compatibilidad preconfigurada de compilación e implementación para Next.js y Angular, en los que nos comprometimos a comprender esos frameworks y a interpretar sus parámetros de configuración nativos. Para una serie de otros frameworks, la comunidad de desarrolladores admite adaptadores de framework de App Hosting. Además, para cualquier aplicación de Node.js con una secuencia de comandos de compilación e inicio, App Hosting intentará realizar compilaciones, pero no puede garantizar el éxito de manera confiable. Consulta Integración de frameworks.

¿Qué regiones admite Firebase App Hosting?

Es probable que las regiones de App Hosting se expandan con el tiempo. Consulta Ubicaciones de App Hosting para obtener la información más actualizada.

¿Puedo usar GitLab o algún otro proveedor de Git que no sea GitHub para las implementaciones?

Actualmente, no puedes, pero la compatibilidad con otros proveedores está en la hoja de ruta a largo plazo para App Hosting.

¿Por qué no puedo encontrar mi repositorio en la IU de la consola de Firebase?

Si tu repositorio no aparece en la lista de opciones cuando creas un backend nuevo en la consola de Firebase, primero intenta seleccionar Actualizar lista. Si el repositorio preferido aún no está disponible, es posible que debas agregarlo con la opción para otorgar acceso a un repositorio nuevo en GitHub.

Además, puedes administrar repositorios con la aplicación de GitHub de Firebase App Hosting. Para ello, ve a tu perfil de GitHub y selecciona Settings y, luego, Applications. En la fila de la tabla de la aplicación Firebase App Hosting, haz clic en Configurar para administrar los repositorios.

¿Por qué mi sitio no se muestra normalmente en WebView de la app para dispositivos móviles Android?

Es posible que las apps que configuraron un dominio personalizado con la consola de Firebase antes del tercer trimestre de 2025 no muestren el sitio correctamente en Android WebView. Esto se debe a que los registros CNAME que se usaron durante ese período no eran compatibles con Android WebView.

Para resolver este problema, quita el dominio personalizado del backend de App Hosting y vuelve a agregarlo. La IU de la consola actualizada proporcionará 3 registros nuevos: un registro A y un registro TXT para el dominio, y un CNAME para el subdominio de desafío de ACME (para certificados). Usa estos registros en lugar del registro CNAME anterior.

¿Cómo cambio el repositorio asociado a mi proyecto de App Hosting?

En la consola de Firebase, abre el backend de App Hosting y ve a Configuración > Implementación. En la sección Repositorio de GitHub, puedes desconectar el repositorio actual o seleccionar otro que esté conectado a tu proyecto.

¿Cómo puedo establecer encabezados para mi sitio de App Hosting?

Los encabezados dependen del framework. Haz lo que harías normalmente para tu framework.

¿Hay un emulador para el desarrollo local con App Hosting?

Sí, puedes realizar pruebas locales de tu app antes de la implementación de App Hosting con el emulador de App Hosting, que forma parte de Firebase Local Emulator Suite. Consulta Prueba la implementación de tu app de forma local.

¿Por qué veo errores en App Hosting, pero no en Cloud Build?

En esos casos, es posible que el error provenga de Cloud Run. Verifica el estado de la actualización progresiva para asegurarte.

¿Cómo cambio o quito una cuenta de GitHub vinculada?

Para quitar la cuenta de GitHub vinculada, abre Developer Connect, asegúrate de que tu proyecto esté seleccionado y borra la conexión firebase-app-hosting-github-oauth y la conexión que comienza con apphosting-github-conn-. Cuando abras App Hosting en la consola de Firebase, deberías poder configurar una nueva conexión de GitHub.

¿Cómo puedo configurar las cookies para mi sitio de App Hosting?

Aunque no estaba disponible en el lanzamiento de la versión preliminar de App Hosting, el encabezado de respuesta HTTP Set-Cookie ahora funciona como se espera.

Limitaciones generales y solución de problemas de App Hosting

• Debido a un problema en la infraestructura de Cloud Run, es posible que la creación o actualización de recursos sea más lenta de lo esperado en algunas regiones, como us-central1. Si la latencia de implementación es un problema en una región en particular, Google recomienda implementar en otra región.
• La CDN de App Hosting solo puede incluir un conjunto específico de encabezados de solicitud en sus claves de caché. Esa lista incluye los encabezados RSC, Next-Router-State-Tree, Next-Router-Prefetch, Next-Router-Segment-Prefetch y Next-Url de NextJS, así como los encabezados estándar 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 y X-Origin de Cloud CDN. Si una respuesta contiene un encabezado Vary con un valor que no se indica aquí, nuestra CDN no la almacenará en caché.
• Los archivos estáticos sin almacenar en caché se entregan desde Cloud Run. En una versión posterior, se almacenarán y entregarán desde el origen de App Hosting para mejorar el rendimiento.
• La consola de Firebase puede mostrar de forma intermitente un error "no se encontró la compilación y no es válida" en la creación del backend.
• Todos los backends del mismo proyecto comparten una organización o cuenta de GitHub. Se pueden conectar a diferentes repositorios en esa organización o cuenta. Para crear backends que estén conectados a diferentes cuentas de GitHub, colócalos en proyectos separados.

Limitaciones y solución de problemas de la app de Angular

Aunque la compatibilidad de App Hosting con Angular está en desarrollo activo y en expansión, tiene las siguientes limitaciones:

• I18n: Si bien la funcionalidad principal de I18n funciona, la navegación directa a las páginas de SSR puede generar errores.
• Localización: No se admite la compilación de versiones para diferentes configuraciones regionales.
• Builders: Por el momento, solo se admite el compilador de aplicaciones.
• Entornos y herramientas de monorepo: Los proyectos de Angular que tengan más de un destino de aplicación fallarán. Para obtener una compatibilidad más completa con monorepo, usa Nx.

Errores HTTP 400 y confianza en el proxy en SSR de Angular

Si tu aplicación de Angular implementada en Firebase App Hosting encuentra errores HTTP 400 (solicitud incorrecta), bloqueadores de validación de host o fallas de confianza del proxy, sigue la solución recomendada para tu versión de Angular:

• Angular v19, v20 y v21: Tienes dos formas de resolver estos errores HTTP 400:
  • Actualiza las dependencias: Ejecuta npm update @angular/core @angular/ssr para instalar la versión de parche más reciente de tu versión actual de Angular.
  • Configuración manual: Aplica un resguardo de configuración a nivel de código estableciendo trustProxyHeaders: true en la configuración de tu servidor (consulta Configura encabezados de proxy de confianza en la documentación de Angular).
• Angular v22: La primera compilación en un backend nuevo podría devolver errores 400. Para resolver el problema, genera una segunda compilación. Todas las compilaciones posteriores deberían funcionar según lo previsto.

Limitaciones y solución de problemas de Next.js

• De forma predeterminada, la optimización de imágenes integrada de NextJS está inhabilitada en App Hosting, a menos que establezcas de forma explícita images.unoptimized como falso o uses un cargador de imágenes personalizado. Consulta Optimiza la carga de imágenes en Next.js.
• De forma predeterminada, Next.js escribe páginas y datos almacenados en caché en el sistema de archivos, lo que se tiene en cuenta para la memoria de cada instancia de entrega en App Hosting. Si tus instancias se reinician con errores Memory limit exceeded, consulta Configura el almacenamiento en caché del servidor en Next.js.
• Actualmente, App Hosting limita el almacenamiento en caché de las apps de NextJS que usan middleware. Con el tiempo, las tasas de aciertos de caché deberían mejorar.
• Cloud Run decodifica las rutas de URL que contienen caracteres codificados con porcentajes. Esto puede causar problemas con las funciones que solo esperan rutas de URL codificadas, como el enrutamiento paralelo de Next.js.