Cómo Solucionar el Error de Exception Smarty en PrestaShop Paso a Paso

¿Qué es el error de Exception Smarty en PrestaShop?

El motor de plantillas Smarty es el encargado de compilar y mostrar la interfaz gráfica de tu tienda en PrestaShop. Cuando se produce un error del tipo SmartyException, significa que el sistema no ha podido interpretar correctamente un archivo de la plantilla (.tpl), ya sea debido a una sintaxis incorrecta, problemas de caché o archivos dañados durante una actualización.

Causas principales del error Smarty

• Modificaciones recientes en los archivos .tpl del tema activo.
• Caché de Smarty corrupta en el servidor.
• Incompatibilidad de módulos de terceros con la versión actual de PrestaShop.
• Ficheros faltantes o con permisos incorrectos en la carpeta de themes.

Método 1: Vaciar la caché de PrestaShop y Smarty manualmente

En la mayoría de los casos, eliminar los archivos de caché acumulados resuelve el conflicto de inmediato.

1. Accede a tu servidor mediante un cliente FTP o el Administrador de Archivos de tu Hosting.
2. Navega hasta el directorio raíz de tu tienda PrestaShop.
3. Entra a la carpeta var/cache/ (en versiones 1.7 y 8.x) o cache/smarty/ (en versiones 1.6).
4. Elimina el contenido de las carpetas prod y dev (o los directorios internos de caché).
5. Vuelve a tu panel de administración (Back-Office) en Parámetros Avanzados > Rendimiento y vacía la caché desde el botón superior.

Método 2: Activar el Modo Debug para identificar el archivo causante

Para saber exactamente qué línea de código está rompiendo Smarty, debes activar el modo de depuración.

1. Accede por FTP a tu tienda y localiza el archivo config/define.inc.php o src/PrestaShopBundle/Controller/Admin/Configure/AdvancedParameters/PerformanceController.php según tu versión, o edítalo desde el archivo config/config.inc.php.
2. Cambia el valor de _PS_MODE_DEV_ de false a true: define('_PS_MODE_DEV_', true);.
3. Recarga la página de tu tienda online donde aparecía el error y ahora verás un stack trace detallado indicando el archivo .tpl exacto y el número de línea con el fallo.

Método 3: Corregir la sintaxis o restaurar la plantilla

Una vez identificado el archivo gracias al Modo Debug:

1. Edita el archivo .tpl afectado utilizando un editor de código como VS Code.
2. Revisa si hay etiquetas de Smarty mal cerradas, por ejemplo: {if ...} sin su correspondiente {/if}.
3. Si recientemente instalaste un módulo, desactívalo temporalmente renombrando su carpeta en modules/ vía FTP para comprobar si el error desaparece.