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 para la compilación y la implementación de Next.js y Angular, en la que nos comprometimos a comprender esos frameworks y a interpretar sus configuraciones nativas. Para varios otros frameworks, la comunidad de desarrolladores admite adaptadores de frameworks.App Hosting Además, para cualquier aplicación de Node.js con una secuencia de comandos de compilación y de 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 App Hosting ubicaciones para obtener la información más actualizada.

¿Puedo usar GitLab o cualquier otro proveedor de Git además de GitHub para las implementaciones?

Actualmente, no puedes hacerlo, 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 Firebase console?

Si tu repositorio no aparece en la lista de opciones cuando creas un backend nuevo en la Firebase consola, 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 Firebase App Hosting aplicación de GitHub. Para ello, ve a tu perfil de GitHub, selecciona Configuración y, luego, Aplicaciones. 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 con normalidad en WebView de la app para dispositivos móviles de Android?

Es posible que las apps que configuraron un dominio personalizado con la consola Firebase antes del tercer trimestre de 2025 no muestren el sitio correctamente en Android WebView. Esto sucede porque 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 App Hosting backend y vuelve a agregarlo. La IU actualizada de la consola proporcionará 3 registros nuevos: un registro A y un registro TXT para el dominio, y un CNAME para el subdominio de desafío ACME (para certificados). Usa estos registros en lugar del registro CNAME anterior.

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

Actualmente, no es posible cambiar el repositorio. Sin embargo, puedes crear un backend nuevo asociado con el repositorio preferido dentro del mismo proyecto o crear un backend nuevo en un proyecto independiente.

¿Cómo puedo establecer encabezados para mi sitio 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 App Hosting implementación con el emulador App Hosting, que forma parte de Firebase Local Emulator Suite. Consulta Prueba localmente la implementación de tu app .

¿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 del lanzamiento 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 esté seleccionado tu proyecto y borra la firebase-app-hosting-github-oath conexión y la conexión que comienza con apphosting-github-conn-. Cuando abras App Hosting en la consola de Firebase, deberías poder configurar una conexión nueva de GitHub.

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

Si bien 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 y solución de problemas generales de App Hosting

• Debido a un problema en la infraestructura, la creación o actualización de recursos puede ser más lenta de lo esperado en algunas regiones, como us-central1.Cloud Run Si la latencia de implementación es un problema en una región en particular, Google recomienda realizar la implementación 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 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 estándar de Cloud CDN. Si una respuesta contiene un encabezado Vary con un valor que no aparece aquí, nuestra CDN no lo almacenará en caché.
• Los archivos estáticos sin caché se entregan desde Cloud Run. En una versión posterior, se almacenarán y se entregarán desde el origen App Hosting para mejorar el rendimiento.
• La consola Firebase puede mostrar de forma intermitente un error de "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

Si bien 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.
• Compiladores: Por el momento, solo se admite el compilador de aplicaciones.
• Entornos y herramientas de Monorepo: Fallarán los proyectos de Angular que tengan más de un destino de aplicación. Para obtener una compatibilidad más completa con Monorepo, usa Nx.

Errores HTTP 400 y confianza de proxy en Angular SSR

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 de 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 errores:
  • 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 una reserva 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 puede mostrar 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 explícitamente images.unoptimized en falso o uses un cargador de imágenes personalizado. Consulta Optimiza la carga de imágenes en Next.js.
• Cloud Run decodifica las rutas de URL que contienen caracteres codificados en porcentaje Cloud Run. Esto puede causar problemas con las funciones que solo esperan rutas de URL codificadas, como el enrutamiento paralelo de Next.js.
• Actualmente, App Hosting limita el almacenamiento en caché para 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 en porcentaje. Esto puede causar problemas con las funciones que solo esperan rutas de URL codificadas, como el enrutamiento paralelo de Next.js