Redirects 301 de WordPress a Astro en astro.config.mjs

Cuando migras una web de WordPress a Astro, las URLs casi nunca coinciden exactamente con las nuevas. Si esas rutas antiguas ya estaban indexadas en Google (con posicionamiento, enlaces entrantes, tráfico…), lo peor que puedes hacer es dejarlas devolviendo un 404 sin más. La solución es un redirect 301 (permanente) desde la ruta antigua a la nueva.

Astro permite definir redirects directamente en la configuración, sin necesitar un plugin aparte:

export default defineConfig({
  redirects: {
    // Inglés — ruta antigua indexada en Google → nueva
    '/en/code': { status: 301, destination: '/blog/codigo/' },

    // Política de privacidad en inglés → versión española
    '/en/privacy-policy': { status: 301, destination: '/politica-de-privacidad/' },
  },
});

La clave es la ruta vieja, status: 301 le dice a los buscadores (y a los navegadores) que es un cambio permanente, no temporal, y destination es la ruta nueva donde quieres que aterrice quien entre ahí.

Cómo sé qué rutas antiguas necesito

Antes de migrar, exporta desde Google Search Console todas las URLs indexadas de la web antigua (en Cobertura o Rendimiento) y compáralas con la nueva estructura de rutas. Cualquier URL antigua con tráfico o enlaces entrantes real merece su redirect, aunque el contenido ya no exista tal cual en la web nueva — en ese caso, redirige a la página más parecida, no a la home a lo loco (Google penaliza los redirects masivos hacia la home cuando no tiene sentido para el usuario).

Con astro build, estos redirects se generan como páginas HTML con meta refresh si el hosting es estático puro, o como redirects reales a nivel de servidor si despliegas en un adaptador con SSR — conviene comprobar cuál de los dos estás usando, porque el 301 real a nivel de servidor es preferible siempre que se pueda.