Por qué migramos un cliente de Vue2 a Nuxt (y qué se rompió por el camino)

El sitio de este cliente inmobiliario llevaba años funcionando en Vue 2 con Vue CLI, y funcionaba bien, esa es la parte incómoda de contar esta historia, porque no migramos porque algo estuviera roto, sino porque Vue 2 dejó de recibir soporte y seguir ahí a medio plazo era acumular deuda técnica a propósito.

La primera sorpresa, y de las gordas, fue el SEO. El sitio viejo era una SPA pura: todo se renderizaba en el cliente, y para una inmobiliaria que vive de que Google indexe bien cada ficha de propiedad, eso ya era un problema antes de tocar nada. Pasar a Nuxt con SSR no fue solo “actualizar dependencias”, fue repensar cómo se generan las URLs de cada propiedad y qué se manda pre-renderizado desde el servidor.

Lo que se rompió, para ser honesta: el sistema de repositorios que hablaba con la API de Symfony. Estaba pensado para axios puro dentro de componentes Vue clásicos, y hubo que adaptarlo entero a composables. No fue difícil, pero sí fue de esas tareas que parecen mecánicas hasta que te encuentras con un endpoint que devuelve un formato distinto según si hay imágenes o no, y nadie recuerda por qué se hizo así.

También se rompió, brevemente, la búsqueda de propiedades en producción, durante unas dos horas, por una diferencia de comportamiento entre cómo Vue 2 y Nuxt manejan el estado reactivo en listados grandes. Lo detectamos rápido porque teníamos un cliente mirando el sitio ese mismo día. No fue nuestro mejor momento, pero se solucionó antes de que se notara demasiado.

¿Mereció la pena? Sí, pero no por lo que se suele vender de estas migraciones. El sitio no es dramáticamente “más rápido” para el usuario medio. Lo que ganamos es que ahora hay un camino claro de mantenimiento para los próximos años, en vez de un armario lleno de dependencias que un día dejan de instalarse.

Si alguien me pregunta cuándo migrar un proyecto que “funciona bien”, mi respuesta es: cuando el coste de no hacerlo empieza a ser mayor que el riesgo de hacerlo con calma, no cuando aparece la próxima versión mayor y ya está.