Corrección: Qwik genera un sitemap.xml vacío

Corrección: Qwik genera un sitemap.xml vacío

Resumen breve: Si al desplegar una aplicación Qwik o Qwik City con el adaptador Node.js el sitemap.xml funciona en local pero aparece vacío en producción, el problema suele ser que el adaptador ejecuta un paso de Static Site Generation SSG durante la compilación y sobrescribe cualquier sitemap estático en public cuando no encuentra rutas exportables. El resultado es un sitemap que solo contiene urlset vacío en producción aunque todo parezca correcto en desarrollo.

Cuál es la causa: El adaptador node-server ejecuta por defecto SSG incluso si la intención es usar SSR en tiempo de ejecución. Si tus rutas son dinámicas o se renderizan solo en SSR, SSG no detecta páginas exportables y genera un sitemap vacío que sustituye al archivo estático.

Solución recomendada para aplicaciones puras SSR: Desactivar SSG y usar un sitemap estático. Pasos esenciales: 1) En la configuración del adaptador node-server establecer ssg: null en la configuración del plugin para desactivar totalmente SSG. 2) Crear un sitemap estático en public/sitemap.xml con todas las rutas conocidas y sus metadatos lastmod changefreq priority. 3) Eliminar cualquier comando qwik city collect de los scripts de build para evitar ejecuciones explícitas de SSG. 4) Compilar y verificar que dist/sitemap.xml contiene tu sitemap y que el servidor Node sirve ese archivo en producción.

Alternativa para sitemaps dinámicos: Si necesitas generar el sitemap desde un CMS o base de datos, crea una ruta SSR que devuelva application XML en runtime y mantén SSG desactivado para evitar sobrescrituras. Este enfoque es útil para contenidos que cambian frecuentemente o para incluir URLs generadas por usuarios.

Errores y confusiones comunes: usar exclude con patrones en lugar de ssg null no desactiva SSG por completo; mantener qwik city collect en los scripts forzará SSG; poner sitemap en dist manualmente no funciona porque dist se limpia en cada build; tener sitemap tanto en public como en una ruta SSR puede producir conflicto y la ruta SSR tendrá preferencia.

Cómo verificar que el arreglo funcionó: comprobar que la salida de build no contiene mensajes Starting Qwik City SSG cuando ssg fue deshabilitado, confirmar que dist/sitemap.xml tiene un tamaño razonable y que curl o la petición HTTP a /sitemap.xml en producción devuelve el contenido esperado.

Notas prácticas y recomendaciones: para sitios multilenguaje incluye todas las variantes de idioma en el sitemap estático o genera dinámicamente las versiones locales desde la ruta SSR; si necesitas redirigir /sitemap.xml/ a /sitemap.xml puedes añadir una regla de redirección simple en el servidor Node para evitar duplicados.

Servicios y ayuda profesional: En Q2BSTUDIO somos especialistas en desarrollo de software y aplicaciones a medida y podemos ayudarte a desplegar correctamente aplicaciones Qwik en entornos cloud, configurar pipelines de CI CD y asegurar que archivos estáticos como sitemap.xml no se sobrescriban en producción. Ofrecemos soluciones de software a medida y aplicaciones a medida adaptadas a tus procesos y requisitos, así como servicios de migración y optimización para AWS y Azure, puedes conocer más sobre nuestros servicios cloud en Servicios cloud AWS y Azure.

Además, en Q2BSTUDIO contamos con experiencia en inteligencia artificial, servicios de inteligencia de negocio y ciberseguridad para proteger tus despliegues y datos. Si tu sitemap requiere generación inteligente basada en datos de negocio o integración con un CMS, podemos implementar soluciones con ia para empresas y agentes IA que actualicen el sitemap automáticamente; consulta nuestras ofertas de desarrollo en software y aplicaciones a medida y descubre cómo integrar Power BI y servicios de inteligencia para potenciar la visibilidad y análisis de tu sitio.

Palabras clave integradas: aplicaciones a medida, software a medida, inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio, ia para empresas, agentes IA y power bi. Si necesitas soporte para corregir un sitemap vacío en producción o auditar tu despliegue Qwik, contacta con Q2BSTUDIO para una consultoría personalizada y un plan de acción claro.