Astro 7.4: perfilado de compilación con la bandera --timings y servicios de imágenes independientesArtículo · digest del 1 de noviembre
Cartel minimalista con el cronometraje de las etapas de compilación del proyecto y una escala de tiempos del compilador
Artículo4 secciones≈ 6 min

Astro 7.4: perfilado de compilación con la bandera --timings y servicios de imágenes independientes

Con el crecimiento de portales de contenido, blogs y sitios corporativos en el framework Astro, el tiempo de generación estática (Static Site Generation, SSG) aumenta inevitablemente. Cuando la base de código crece hasta cientos o miles de páginas, el proceso de compilación corre el riesgo de convertirse en una «caja negra»: en la terminal gira un spinner infinito de compilación y el desarrollador intenta adivinar qué frena exactamente el proceso. ¿Tienen la culpa pesados plugins de Vite, la validación de colecciones de contenido con Zod, el parseo de árboles Markdown o la lenta optimización de imágenes mediante la librería Sharp?

A finales de octubre de 2026, la desarrolladora Sarah Rainsberger presentó en el blog oficial de Astro el lanzamiento menor Astro 7.4. La actualización continúa la evolución de la línea del framework iniciada en el lanzamiento Astro 7.3, y aporta herramientas de transparencia sin concesiones: una bandera global de diagnóstico --timings, la separación de los manejadores de medios en fases de compilación y tiempo de ejecución, así como el nuevo manejador notFound() para puntos de entrada personalizados.

Perfilado con la bandera --timings: radiografía de las fases de compilación

La principal novedad para desarrolladores de proyectos grandes fue el perfilador integrado, activable con una sola bandera de línea de comandos:

# Ejecución de la compilación del proyecto mostrando una tabla jerárquica detallada de tiempos
npx astro build --timings

La herramienta de medición de rendimiento está integrada directamente en el pipeline AstroBuild y envuelve los hooks clave del ciclo de vida en marcas estándar de la Performance API del navegador (performance.mark y performance.measure).

Al finalizar la compilación, la consola muestra un desglose detallado del tiempo por las fases clave de compilación:

  • Configuración de Vite y plugins: muestra el tiempo de inicialización del entorno de compilación y de ejecución de transformaciones de terceros;
  • Validación de Content Collections: mide la comprobación de esquemas de datos mediante Zod;
  • Parseo de Markdown y resaltado de sintaxis: refleja el coste de generar árboles de sintaxis abstracta y el trabajo de los parsers Shiki o Prism;
  • Optimización de imágenes: registra el tiempo neto de compresión y conversión de assets gráficos con Sharp;
  • Prerenderizado de páginas estáticas: muestra la duración total de generación de HTML y arma un top-5 separado de las páginas más lentas del proyecto (Slowest Routes), ayudando a localizar al instante componentes «pesados».

En esta salida me llamó la atención la precisión de la localización: si una de las páginas consulta una API GraphQL externa lenta o ejecuta una consulta SQL pesada en el frontmatter, ves su nombre de inmediato en la lista de las rutas más lentas en lugar de buscar manualmente por los logs.

Separación de image.service: dieta para las funciones de servidor

La segunda mejora arquitectónica fundamental de Astro 7.4 atañe a la optimización del tamaño de los artefactos desplegados en proyectos híbridos y de servidor (SSR).

Antes los desarrolladores declaraban el servicio de procesamiento de imágenes de forma global: si el proyecto usaba el potente paquete en C++ Sharp, sus binarios compilados se arrastraban tanto a la etapa de generación estática como a funciones serverless en AWS Lambda, Cloudflare Workers o Vercel Edge. Como resultado, el tamaño del bundle serverless se inflaba en 20–30 megabytes, provocando retrasos perceptibles en el arranque en frío (Cold Start).

En Astro 7.4, el objeto de configuración image.service permite configurar de forma independiente los manejadores para la etapa de compilación (build) y para el tiempo de ejecución (runtime):

// astro.config.mjs: configuración independiente de los servicios de procesamiento de imágenes
import { defineConfig, passthroughImageService } from 'astro/config';
import node from '@astrojs/node';

export default defineConfig({
  output: 'hybrid',
  adapter: node({ mode: 'standalone' }),
  image: {
    service: {
      // En la etapa de compilación estática usamos Sharp local para máxima compresión
      build: {
        entrypoint: 'astro/assets/services/sharp',
        config: {
          limitInputPixels: true,
        },
      },
      // En el runtime del servidor SSR desactivamos cálculos pesados y devolvemos las URL originales
      runtime: passthroughImageService(),
    },
  },
  experimental: {
    // Activación de la generación multihilo de páginas en todos los núcleos del procesador
    parallelPrerender: true,
  },
});

Gracias a esta separación, los gráficos estáticos se comprimen con la máxima calidad en la máquina del desarrollador o en CI, mientras que el contenedor del servidor permanece ligero y arranca en cuestión de milisegundos.

Manejador programático notFound() en endpoints de API

Hasta el lanzamiento 7.4, al crear endpoints personalizados de servidor (API Routes) o integrar Astro con servidores HTTP de microservicios (por ejemplo, Hono o Fastify), devolver un error 404 estándar se volvía un problema: retornar un JSON plano resultaba incómodo, y renderizar una bonita página personalizada 404.astro exigía apaños importando manualmente componentes de layout.

En Astro 7.4 apareció el manejador declarativo notFound(), disponible directamente en el contexto de la ruta:

// src/pages/api/posts/[slug].ts: retorno programático de la página nativa 404
import type { APIRoute } from 'astro';
import { getPostBySlug } from '../../../lib/db';

export const GET: APIRoute = async ({ params, notFound }) => {
  const post = await getPostBySlug(params.slug);

  if (!post) {
    // Invoca el renderizado completo de la página 404.astro conservando cabeceras y estilos
    return notFound();
  }

  return new Response(JSON.stringify(post), {
    status: 200,
    headers: { 'Content-Type': 'application/json' },
  });
};

Prerenderizado paralelo experimental

Para proyectos de contenido realmente grandes con decenas de miles de páginas, Astro 7.4 introduce multihilo experimental mediante la bandera experimental.parallelPrerender.

En lugar de renderizar páginas de forma secuencial en el hilo principal de Node.js, el framework levanta un pool de workers en segundo plano (Worker Threads) y reparte uniformemente la cola de rutas estáticas entre todos los núcleos disponibles de la CPU. En estaciones de trabajo y runners de CI modernos de 8 y 16 núcleos, esto reduce el tiempo total de compilación de sitios a gran escala entre 2 y 4 veces sin cambiar la lógica de las plantillas.

Completan el panorama las páginas de redirección personalizadas (Custom Redirect Pages): si antes Astro generaba un HTML por defecto con la metaetiqueta http-equiv="refresh", ahora los desarrolladores pueden conectar su propia plantilla de marca para la página de redirección con cabeceras arbitrarias y animación de espera.

El lanzamiento menor Astro 7.4 demuestra con claridad la madurez de la plataforma: los desarrolladores del núcleo se centraron no en el hype pasajero, sino en herramientas profundas y prácticas de optimización que dan a los ingenieros control total sobre la velocidad y los recursos de las aplicaciones web.

Quiero un análisis detalladoLos votos ayudan a elegir qué analizar a fondo. Este material tiene 0 votos.
Fuentes · 2