Cómo Solucionar la Excepción de Smarty en PrestaShop Paso a Paso

¿Qué es una Excepción de Smarty en PrestaShop y por qué ocurre?

Smarty es el motor de plantillas que utiliza PrestaShop para separar la lógica de programación del diseño visual. Cuando se produce una excepción de Smarty, significa que el sistema ha encontrado un fallo crítico al compilar o renderizar un archivo .tpl (plantilla). Esto suele ocurrir tras actualizar un módulo, modificar el tema activo, o debido a incompatibilidades con la versión de PHP.

Causas principales del error de Smarty

• Errores de sintaxis en archivos de plantilla personalizados o modificados recientemente.
• Archivos de caché corruptos en la carpeta var/cache o tools/smarty/cache.
• Incompatibilidad de versiones de PHP con funciones obsoletas dentro de las plantillas.
• Falta de permisos de escritura en los directorios de caché y compilación.

Método 1: Vaciar y regenerar la caché de PrestaShop

La causa más común de una excepción de Smarty es la corrupción de archivos temporales en el servidor. Para solucionarlo, debes purgar la caché manualmente:

1. Accede a tu servidor mediante un cliente FTP (como FileZilla) o el Administrador de Archivos de tu cPanel.
2. Navega hasta la raíz de tu instalación de PrestaShop.
3. Entra en la carpeta var y localiza el directorio cache (en versiones antiguas puede estar en app/cache o tools/smarty/cache).
4. Elimina el contenido de las carpetas prod y dev (o borra la carpeta cache entera, asegurándote de no borrar el archivo index.php si lo contiene).
5. Entra en el panel de administración (Backoffice) de PrestaShop, ve a Parámetros avanzados > Rendimiento y haz clic en el botón Borrar la caché.

Método 2: Desactivar la compilación y activar el modo debug

Si vaciar la caché no funciona, necesitas ver el mensaje exacto del error para identificar qué archivo provoca el fallo:

1. Abre el archivo de configuración ubicado en config/defines.inc.php o modifica el archivo app/config/parameters.php dependiendo de tu versión.
2. Cambia el valor de _PS_MODE_DEV_` de false a true para habilitar el modo depuración.
3. Vuelve a cargar tu tienda online en el navegador; ahora verás una traza detallada (stack trace) que indicará el archivo .tpl exacto y la línea donde se origina la excepción.
4. Corrige el error de sintaxis en dicho archivo Smarty o reemplázalo con una copia de seguridad limpia.
5. Una vez solucionado, recuerda volver a cambiar _PS_MODE_DEV_ a false por razones de seguridad.