Preguntas frecuentes y solución de problemas

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

Preguntas frecuentes sobre App Hosting

¿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 los 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 de 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 forma confiable. Consulta Integración del framework.

¿En qué regiones está disponible Firebase App Hosting?

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

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

Actualmente, no puedes hacerlo, pero la compatibilidad con otros proveedores está en la hoja de ruta a largo plazo de 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 Firebase console, primero intenta seleccionar Actualizar lista. Si el repositorio preferido aún no está disponible, es posible que debas agregarlo con la opción Otorga acceso a un repositorio nuevo en GitHub.

Además, puedes administrar repositorios con la aplicación de GitHub Firebase App Hosting. Para ello, ve a tu perfil de GitHub, selecciona Configuración y, luego, Aplicaciones. En la fila de la tabla correspondiente a 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 los sitios de las apps que configuraron un dominio personalizado con Firebase console antes del tercer trimestre de 2025 no se muestren correctamente en WebView de Android. Esto ocurre 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 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 los certificados). Usa estos registros en lugar del registro CNAME anterior.

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

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

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

Los encabezados dependen del framework. Haz lo que harías normalmente con 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 Cómo probar 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 tu proyecto esté seleccionado y borra la conexión firebase-app-hosting-github-oath 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 establecer cookies para mi sitio de 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 generales de App Hosting y solución de problemas

• Debido a un problema en la infraestructura de Cloud Run, la creación o actualización de recursos puede ser 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 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 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 lo 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 App Hosting para mejorar el rendimiento.
• La consola de Firebase puede mostrar de forma intermitente un error de "no se encontró la compilación y no es válida" durante 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 de esa organización o cuenta. Para crear back-ends 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 con App Hosting para 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 Application builder.
• 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 monorepos, usa Nx.

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 images.unoptimized de forma explícita como falso o uses un cargador de imágenes personalizado. Consulta Cómo optimizar la carga de imágenes en Next.js.
• Cloud Run decodifica las rutas de URL que contienen caracteres codificados como porcentaje. 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é de las apps de NextJS con middleware. Con el tiempo, las tasas de aciertos de caché deberían mejorar.
• Cloud Run decodifica las rutas de acceso 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.