Error 'No route found' en PrestaShop: Soluciones rápidas

¿Acabas de toparte con el temido error No route found PrestaShop? No te preocupes, es uno de los avisos más comunes cuando se trabaja con esta plataforma, pero también de los más fáciles de resolver si sabes exactamente dónde mirar. Este error suele aparecer como un mensaje en blanco o con un código de estado 404, y puede desconcertar incluso a usuarios con algo de experiencia.

En esta guía extensa y paso a paso, te voy a explicar qué significa este error, por qué ocurre y, lo más importante, cómo solucionarlo de forma definitiva. Vamos a ello.

¿Qué significa exactamente el error "No route found"?

El mensaje técnico completo suele ser algo como: No route found for "GET /nombre-de-tu-pagina". En términos sencillos, significa que PrestaShop está intentando encontrar una "ruta" (es decir, una URL concreta) para mostrar una página, pero no la encuentra en su sistema de enrutamiento interno.

Piensa en PrestaShop como un gran edificio con miles de puertas. Cada puerta tiene una etiqueta (la URL). Cuando escribes una dirección en el navegador, el sistema busca esa etiqueta. Si la etiqueta no coincide con ninguna puerta, te muestra el error. Este fallo puede deberse a que la puerta fue movida, la etiqueta se borró o el mapa de puertas (el archivo de rutas) está desactualizado.

Las causas más frecuentes de este error

Antes de lanzarnos a solucionarlo, es vital entender qué lo provoca. Las causas más habituales son:

URLs amigables mal configuradas: Esta es la causa número uno. Si activaste las URLs amigables de PrestaShop y no se generaron correctamente, el sistema no sabe cómo enlazar las páginas.
Problemas con el archivo .htaccess: Este archivo es el "director de tráfico" de tu servidor. Si está dañado, incompleto o con permisos incorrectos, las rutas no se resuelven.
Actualizaciones incompletas: Si acabas de actualizar PrestaShop o migrar de servidor, es posible que las tablas de rutas en la base de datos no se hayan actualizado.
Módulos conflictivos: Algún módulo de terceros puede estar sobrescribiendo las rutas principales y provocando el error.
Problemas de caché: Una caché corrupta (tanto la de PrestaShop como la del navegador) puede mostrar rutas antiguas que ya no existen.

Solución paso a paso para el error "No route found"

Vamos a arreglarlo. Te recomiendo seguir los pasos en este orden, ya que van de lo más simple a lo más complejo. No te saltes ninguno sin probarlo antes.

Paso 1: Regenerar las URLs amigables de PrestaShop (La solución más común)

Este es el primer paso y el que resuelve el 90% de los casos. Las URLs amigables PrestaShop son esenciales para el SEO y el funcionamiento interno, pero a veces se "desincronizan".

Para regenerarlas, sigue estos pasos:

Accede al panel de administración de tu tienda (la URL terminada en /admin o similar).
Ve al menú Configuración avanzada en el panel lateral izquierdo.
Haz clic en SEO y URLs.
En la pestaña superior, verás dos opciones: Configurar URLs amigables y Configurar URL de la tienda. Asegúrate de estar en la primera.
No cambies nada de lo que ves. Simplemente, en la parte inferior de la página, haz clic en el botón Guardar (o "Guardar y regenerar", dependiendo de la versión).
PrestaShop regenerará automáticamente el archivo .htaccess y las rutas internas.

[TIP]: Si el botón dice "Guardar", pero no ves cambios, prueba a desmarcar la casilla "URLs amigables", guardar, volver a marcarla y guardar de nuevo. Esto fuerza una regeneración completa.

Paso 2: Verificar y reparar el archivo .htaccess

Si el paso anterior no funcionó, el problema puede estar en el archivo .htaccess. Este archivo se encuentra en la raíz de tu instalación de PrestaShop (normalmente en public_html/ o www/).

Cómo comprobarlo:

Accede a tu hosting mediante el Administrador de Archivos o un cliente FTP como FileZilla.
Busca el archivo .htaccess. Ojo: Los archivos que empiezan por un punto están ocultos por defecto. Deberás activar la opción "Mostrar archivos ocultos" en tu cliente FTP o en el administrador de archivos.
Si el archivo existe, descárgalo a tu ordenador como copia de seguridad.
Ahora, bórralo del servidor.
Vuelve al panel de administración de PrestaShop y repite el Paso 1 (regenerar URLs). Al guardar, PrestaShop creará un archivo .htaccess nuevo y limpio.

[WARNING]: No edites el .htaccess manualmente a menos que sepas exactamente lo que haces. Un error aquí puede dejar tu tienda completamente inaccesible con un error 500.

Paso 3: Limpiar la caché de PrestaShop

A veces, el error no es de rutas, sino de memoria caché. PrestaShop guarda copias de las páginas para cargarlas más rápido. Si esa copia está dañada, muestra el error.

Para limpiarla:

En el panel de administración, ve a Configuración avanzada.
Haz clic en Rendimiento.
En la parte superior, verás un botón que dice Borrar la caché. Haz clic en él.
También puedes forzar la compilación de las plantillas. En la sección "Plantillas", cambia la opción "Forzar la compilación" a Sí. Guárdalo y luego vuelve a ponerlo en "Nunca" para no perder velocidad.

[INFO]: Si no tienes acceso al panel de administración porque el error te lo impide, borra la caché manualmente. Conéctate por FTP y elimina el contenido de las carpetas /var/cache/prod/ y /var/cache/dev/ (en versiones nuevas) o /cache/smarty/ (en versiones antiguas). No borres las carpetas en sí, solo su contenido.

Paso 4: Desactivar módulos conflictivos

Algunos módulos, especialmente los de SEO, reescritura de URLs o los que modifican el "router", pueden romper las rutas.

Cómo identificar al culpable:

Ve a Módulos -> Administrador de módulos.
En la lista, busca módulos que no sean de PrestaShop (los de terceros).
Desactiva los módulos sospechosos uno por uno. Después de cada desactivación, prueba a cargar la página que daba error.
Cuando el error desaparezca, habrás encontrado al culpable. Puedes mantenerlo desactivado o contactar con el desarrollador del módulo.

[TIP]: Los módulos de "canonicalización", "redirección" o "multitienda" suelen ser los que más problemas dan con las rutas.

Paso 5: Verificar la configuración en Syspanel (Antes HestiaCP)

Si gestionas tu hosting a través de Syspanel (la herramienta de administración de servidores, cuyo puerto de acceso es el 2106), es posible que el problema venga de la configuración del dominio o del PHP.

Accede a Syspanel usando https://tu-dominio.com:2106.
Ve a la sección de Web o Dominios y localiza tu tienda.
Asegúrate de que el dominio apunta a la carpeta correcta (normalmente public_html).
Revisa que la versión de PHP sea compatible con tu versión de PrestaShop. Una versión de PHP desactualizada puede provocar errores de enrutamiento.

[WARNING]: Cambiar la versión de PHP puede afectar a otros sitios web en el mismo servidor. Si no estás seguro, pregunta a tu proveedor de hosting antes de hacer cambios.

Paso 6: Reinstalar el archivo de rutas desde la base de datos (Solución avanzada)

Este es un paso más técnico, pero muy efectivo. El error puede deberse a que las tablas ps_meta o ps_layer (que contienen las rutas) están corruptas o incompletas.

Accede a phpMyAdmin desde Syspanel o tu panel de hosting.
Selecciona la base de datos de tu PrestaShop.
Busca la tabla ps_meta (el prefijo ps_ puede variar si lo cambiaste en la instalación).
Vaciéla (opción "Vaciar" o "TRUNCATE"). Esto eliminará todas las rutas.
Vuelve al panel de administración de PrestaShop y ve a Configuración avanzada -> SEO y URLs.
Haz clic en Añadir nueva página para crear una ruta nueva (o simplemente guarda la configuración). PrestaShop regenerará automáticamente todas las rutas por defecto.

[INFO]: Este método es seguro, ya que PrestaShop regenera las rutas base automáticamente. Eso sí, si tenías rutas personalizadas para categorías o productos, las perderás y deberás configurarlas de nuevo.

Cómo prevenir futuros errores de ruta

Una vez que hayas solucionado el error, toma nota de estas buenas prácticas para que no vuelva a ocurrir:

Realiza copias de seguridad periódicas de tu base de datos y archivos.
Antes de actualizar PrestaShop, módulos o temas, haz siempre una copia de seguridad.
No instales módulos de fuentes dudosas. Pueden contener código malicioso que altere las rutas.
Mantén el archivo .htaccess siempre con permisos 644 y sin modificaciones manuales innecesarias.
Revisa la caché regularmente, sobre todo después de hacer cambios importantes en la tienda.

Preguntas frecuentes (FAQ) sobre el error No route found

¿Por qué me aparece el error solo en algunas páginas?

Esto suele indicar que el problema es específico de una categoría o producto. Prueba a regenerar las URLs amigables desde el panel. Si persiste, es probable que el producto o categoría en cuestión tenga un "enlace permanente" (URL) vacío o con caracteres extraños.

¿El error afecta a mi posicionamiento SEO?

Sí, un error 404 o "No route found" puede afectar negativamente a tu SEO si se mantiene durante mucho tiempo. Google interpreta que la página no existe y puede eliminarla de su índice. Es crucial solucionarlo lo antes posible.

¿Puedo solucionar el error sin acceso al panel de administración?

Sí, puedes intentar borrar la caché manualmente por FTP (Paso 3) o reparar el .htaccess (Paso 2). Si el problema es de base de datos, necesitarás acceso a phpMyAdmin.

He probado todos los pasos y sigo con el error. ¿Qué hago?

En ese caso, el problema puede ser más profundo (conflictos de servidor, archivos corruptos). Te recomiendo contactar con tu proveedor de hosting o con un desarrollador especializado en PrestaShop. Proporciona todos los detalles del error y los pasos que ya has intentado.

Conclusión: No temas al error, es cuestión de método

El error No route found PrestaShop puede parecer un muro infranqueable, pero como has visto, es un problema lógico que tiene una solución metódica. La clave está en la paciencia y en seguir los pasos en orden. Empieza siempre por lo más sencillo (regenerar URLs) y ve subiendo la complejidad solo si es necesario.

Recuerda que una buena higiene de mantenimiento (copias de seguridad, módulos fiables y caché limpia) es tu mejor aliado para evitar estos dolores de cabeza. Con esta guía, ya tienes todas las herramientas para solucionar errores PrestaShop como un profesional. ¡Manos a la obra y a recuperar tu tienda!