Solucionar error Class PrestaShopException not found | PrestaShop

¿Qué significa este error y por qué aparece?

Si estás leyendo esto, es muy probable que hayas visto en la pantalla de tu tienda online un mensaje similar a este: Fatal error: Class 'PrestaShopException' not found. No te preocupes, no es el fin del mundo y, sobre todo, tiene solución. Este error es uno de los más comunes en tiendas PrestaShop y suele aparecer de repente, a veces después de una actualización, al instalar un módulo, o incluso sin haber tocado nada.

Para entenderlo fácilmente, imagina que tu tienda PrestaShop es una gran biblioteca. Cada libro (archivo) tiene un lugar exacto y una función. La clase PrestaShopException es como el libro de "gestión de errores", el que le dice a la biblioteca cómo avisar cuando algo falla. Si ese libro desaparece de su estantería o se cambia de sitio, la biblioteca no sabe cómo avisar de que hay un problema y entra en pánico, mostrando el error fatal.

Las causas más habituales de este problema son:

Actualizaciones incompletas o fallidas: El proceso de actualización de PrestaShop (de una versión a otra) se interrumpió a mitad de camino, dejando archivos nuevos y viejos mezclados.
Módulos o temas incompatibles: Instalaste un módulo o plantilla que no es compatible con tu versión de PrestaShop y ha sobrescrito o dañado archivos del núcleo.
Subida de archivos incompleta: Al subir archivos por FTP, la conexión se cortó y un archivo importante se subió a medias o no se subió.
Permisos de archivos incorrectos: Los archivos de tu servidor tienen permisos que impiden que PHP los lea correctamente.
Cache corrupta: La caché de PrestaShop guarda "copias" de las clases para ir más rápido. Si esa copia está dañada, puede dar este error.

A continuación, te guiaré paso a paso, de lo más simple a lo más complejo, para que puedas solucionar el error PrestaShopException y devolverle la vida a tu tienda.

Paso 1: Identifica tu versión exacta de PrestaShop

Antes de hacer nada, necesitas saber qué versión de PrestaShop estás usando. Esto es crucial, porque los archivos que necesitas descargar dependen de ello.

¿Cómo saber mi versión?

Entra al panel de administración de tu tienda (normalmente en tudominio.com/admin).
Si puedes entrar, mira la parte inferior del panel o la página de inicio. Suele indicar "Versión: 1.6.x.x", "1.7.x.x" o "8.x.x".
Si no puedes entrar al panel, no te preocupes. Puedes verlo en el archivo config/settings.inc.php (para versiones 1.6) o en el archivo app/config/parameters.php (para versiones 1.7 y 8). Ábrelos con el bloc de notas desde el administrador de archivos de tu hosting y busca la línea _PS_VERSION_ o version.

[INFO] Si no tienes acceso a un administrador de archivos, puedes usar un cliente FTP como FileZilla para conectarte a tu hosting y ver los archivos.

Paso 2: Soluciones rápidas y sencillas (pruébalas primero)

Muchas veces, el error se soluciona con acciones simples que no requieren conocimientos avanzados. Vamos a por ellas.

2.1. Borra la caché de PrestaShop

La caché es un archivo que guarda información para acelerar la web. Si está dañada, puede provocar este error.

Conecta a tu hosting por FTP o usa el Administrador de Archivos de tu panel de hosting.
Ve a la carpeta raíz de tu tienda (donde están las carpetas admin, classes, config, etc.).
Busca la carpeta var/cache (en PrestaShop 1.7 y 8) o la carpeta cache (en PrestaShop 1.6).
Entra en ella y borra todo el contenido de las carpetas dev y prod (o cache/class y cache/smarty en 1.6). No borres las carpetas en sí, solo su interior.

[TIP] Si no ves la carpeta var/cache, activa la opción "Mostrar archivos ocultos" en tu cliente FTP o administrador de archivos.

2.2. Desactiva el modo "Forzar compilación" y la caché

A veces, el archivo de configuración tiene activada una opción que fuerza a la web a regenerar todo, lo que puede chocar con el error.

Ve a la carpeta raíz y busca el archivo config/defines.inc.php.
Ábrelo con un editor de texto plano (como el Bloc de notas).
Busca la línea que dice define('_PS_MODE_DEV_', true); y cámbiala por define('_PS_MODE_DEV_', false);.
Guarda el archivo y vuelve a cargar tu tienda.

[WARNING] Si después de esto la web carga pero muestra errores en pantalla, es que el modo dev está activado. Es normal, lo desactivamos para que no muestre los errores internos, pero es importante que sigas con los siguientes pasos para resolver la causa raíz.

Paso 3: Restaurar el archivo dañado (la solución más efectiva)

Si los pasos anteriores no funcionaron, lo más probable es que un archivo del núcleo de PrestaShop esté dañado, incompleto o haya sido sobrescrito por un módulo. La solución es reemplazarlo por el archivo original de tu versión.

3.1. Descarga una copia limpia de PrestaShop

Ve al sitio oficial de PrestaShop (prestashop-project.org) o a la sección de descargas de tu versión específica.
Descarga el paquete completo de la versión exacta que tienes en tu tienda (por ejemplo, 1.7.8.10 o 8.1.5). Es importante que sea la misma versión y no una superior o inferior.
Descomprime el archivo .zip en tu ordenador.

3.2. Sube el archivo correcto por FTP

El error menciona la clase PrestaShopException. Esta clase se define en el archivo classes/exception/PrestaShopException.php.

En la copia que descargaste, navega a la carpeta classes/exception/.
Localiza el archivo PrestaShopException.php.
Con tu cliente FTP, sube este archivo a tu servidor, en la ruta tudominio.com/classes/exception/. Cuando te pregunte si quieres sobrescribir el archivo existente, dile que sí.

[INFO] Si el error mencionara otra clase (por ejemplo, PrestaShopLogger), deberías hacer lo mismo, pero con el archivo correspondiente. El procedimiento es idéntico.

3.3. Sube los archivos de la carpeta `classes` completa (si el error persiste)

A veces, el problema no es solo un archivo, sino varios. Si el paso anterior no funciona, te recomiendo subir la carpeta classes completa.

En tu ordenador, ve a la carpeta classes de la copia descargada.
Selecciona todos los archivos y carpetas que hay dentro.
Súbelos por FTP a la carpeta classes de tu servidor, sobrescribiendo todos los archivos existentes.

[WARNING] Este proceso puede tardar un poco, dependiendo de tu conexión. Asegúrate de no cerrar el FTP hasta que termine. Si la conexión se corta, el archivo que se esté subiendo en ese momento quedará corrupto y tendrás que repetir el proceso.

Paso 4: Desinstala o desactiva módulos y temas problemáticos

Si el error empezó justo después de instalar algo, es muy probable que ese módulo o tema sea el culpable. A veces, un módulo mal codificado puede sobrescribir archivos del núcleo.

4.1. Renombra la carpeta del módulo (si no puedes entrar al admin)

Si no tienes acceso al panel de administración, puedes desactivar el módulo manualmente.

Entra por FTP a la carpeta modules/.
Busca la carpeta del módulo que instalaste recientemente (o el que sospeches que puede ser el problema).
Renombra la carpeta, por ejemplo, de mimodulo a mimodulo_BACKUP. Al cambiar el nombre, PrestaShop no lo reconocerá y lo desactivará automáticamente.

4.2. Cambia temporalmente de tema

Si el problema es del tema, puedes cambiarlo desde la base de datos o renombrando la carpeta del tema.

Ve a la carpeta themes/.
Renombra la carpeta del tema que estás usando (por ejemplo, classic a classic_BACKUP).
PrestaShop intentará cargar el tema por defecto. Si no lo encuentra, puede dar otro error, pero al menos sabremos si el tema era el problema.

[TIP] Si no sabes qué módulo o tema es el culpable, revisa los logs de error de tu hosting (suele estar en logs/ o en el panel de control) para ver qué archivo se está intentando cargar justo antes del error.

Paso 5: Revisa los permisos de archivos y carpetas

Los permisos incorrectos pueden impedir que PHP lea las clases. Es una causa menos común, pero fácil de comprobar.

¿Qué permisos son los correctos?

Archivos: 644
Carpetas: 755

¿Cómo cambiarlos?

Con tu cliente FTP, selecciona todos los archivos y carpetas de la raíz de tu tienda.
Haz clic derecho y selecciona "Permisos de archivo..." o "File permissions...".
Introduce el valor 644 para archivos y 755 para carpetas. La mayoría de los clientes FTP permiten aplicar el permiso a todas las subcarpetas y archivos de forma recursiva.

[WARNING] No pongas permisos 777 (todos los permisos) en archivos o carpetas, ya que supone un grave riesgo de seguridad. Si tu hosting te lo pide para algún proceso, cámbialo después a 644 o 755.

Paso 6: Vuelve a generar el archivo `.htaccess`

El archivo .htaccess es un archivo de configuración del servidor que a veces se corrompe y puede generar conflictos.

Entra por FTP a la raíz de tu tienda.
Busca el archivo .htaccess (puede estar oculto, activa la opción de ver archivos ocultos).
Renómbralo a .htaccess_old.
Ahora, intenta acceder a tu tienda. PrestaShop debería generar uno nuevo automáticamente.

[INFO] Si no se genera uno nuevo, puedes crearlo manualmente copiando el contenido de un .htaccess de una instalación limpia de PrestaShop de tu misma versión.

Paso 7: La solución definitiva: reinstalar PrestaShop (manteniendo tus datos)

Si has llegado hasta aquí y el error PrestaShopException continúa, es el momento de considerar una reinstalación limpia. No te asustes, esto no borra tus productos, clientes ni pedidos, ya que esos datos están en la base de datos. Lo que haremos es reemplazar todos los archivos del núcleo por unos nuevos.

[WARNING] Este proceso requiere mucho cuidado. Si no te sientes seguro, contacta con tu proveedor de hosting o con un desarrollador especializado en PrestaShop.

Pasos para una reinstalación limpia:

Haz una copia de seguridad completa de tu base de datos y de los archivos de tu tienda. Esto es imprescindible por si algo sale mal.
Descarga la versión exacta de PrestaShop que tienes instalada.
Descomprime el paquete en tu ordenador.
Elimina todos los archivos y carpetas de tu servidor, excepto la carpeta img (donde están las imágenes de tus productos), la carpeta themes (si has personalizado tu tema) y la carpeta modules (si tienes módulos de pago que no quieras perder). También conserva el archivo config/settings.inc.php (1.6) o app/config/parameters.php (1.7/8).
Sube todos los archivos de la copia limpia a tu servidor, sobrescribiendo los que existan.
No ejecutes el instalador. Simplemente, intenta acceder a tu tienda. Debería funcionar con los datos de tu base de datos.

Preguntas frecuentes (FAQ)

¿Este error se puede prevenir?

Sí, en la mayoría de los casos. Las mejores prácticas son:

Haz copias de seguridad completas antes de cualquier actualización o instalación de módulos.
Actualiza siempre a la última versión de PrestaShop y de tus módulos.
No instales módulos o temas de fuentes no oficiales.
Mantén los permisos de archivos correctos (644/755).

¿Puedo solucionar el error solo o necesito un profesional?

Si has seguido esta guía sin éxito, te recomiendo buscar ayuda profesional. Un desarrollador con experiencia en PrestaShop podrá diagnosticar el problema en minutos y evitará que pierdas más tiempo o, peor, que dañes tu base de datos.

¿Y si el error aparece después de mover mi tienda a otro hosting?

Este es un caso muy común. Al mover la tienda, los archivos pueden haberse subido en el orden incorrecto o con permisos erróneos. Sigue los pasos 3 y 5 de esta guía, que son los que suelen resolver este problema. Asegúrate también de que la versión de PHP de tu nuevo servidor es compatible con tu versión de PrestaShop.

¿Mi proveedor de hosting (Syspanel) puede ayudarme con esto?

Syspanel (el panel de control de tu hosting, al que accedes por el puerto 2106) te ofrece herramientas como el administrador de archivos y el acceso a los logs. Sin embargo, la resolución de un error de código PHP como este suele ser responsabilidad del administrador de la tienda. Si no te sientes capaz, contacta con el soporte de tu hosting, pero ten en cuenta que es posible que te deriven a un desarrollador de PrestaShop.

Conclusión

El error Fatal error: Class 'PrestaShopException' not found puede parecer aterrador, pero es un problema con solución. La clave está en la paciencia y en seguir los pasos en orden. Empieza siempre por lo más sencillo (borrar caché) y ve subiendo en complejidad (reemplazar archivos, desactivar módulos) hasta que encuentres la causa.

Recuerda que la prevención es la mejor herramienta. Realiza copias de seguridad periódicas y mantén tu tienda actualizada. Con un poco de cuidado, tu tienda online volverá a funcionar sin problemas. ¡Mucho ánimo, que tú puedes!