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

¿Qué es el Error de Excepción de Smarty en PrestaShop?

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, por lo general verás un mensaje en pantalla que indica un fallo en la compilación o renderizado de una plantilla .tpl. Esto puede bloquear tanto el front-office como el back-office de tu e-commerce.

Principales Causas del Error de Smarty

• Modificaciones erróneas en los archivos de la plantilla (archivos .tpl).
• Problemas de permisos de escritura en la carpeta /var/cache/.
• Incompatibilidad de un módulo recién instalado con la versión actual de PrestaShop.
• Corrupción en los archivos de caché generados por el motor Smarty.

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

A menudo, el error se debe a archivos temporales corruptos. Para solucionarlo, puedes vaciar la caché de forma manual mediante tu cliente FTP o el Administrador de Archivos de tu Hosting.

1. Accede a los archivos de tu tienda utilizando un cliente FTP (como FileZilla).
2. Navega hasta la ruta /var/cache/ de tu instalación de PrestaShop.
3. Localiza las carpetas prod y dev dentro del directorio cache.
4. Elimina el contenido de ambas carpetas (o las carpetas completas, asegurándote de no borrar la carpeta principal cache).
5. Vuelve a cargar tu sitio web para comprobar si el error ha desaparecido.

Método 2: Desactivar la compilación de Smarty desde la Base de Datos

Si el error te impide acceder por completo al panel de administración (Back Office), puedes modificar el comportamiento de Smarty directamente desde la base de datos usando phpMyAdmin.

1. Entra a phpMyAdmin desde el panel de control de tu hosting.
2. Selecciona la base de datos correspondiente a tu tienda PrestaShop.
3. Busca la tabla ps_configuration (el prefijo ps_ puede variar según tu configuración).
4. Utiliza la pestaña de búsqueda o filtra para encontrar los registros con los nombres PS_SMARTY_FORCE_COMPILE y PS_SMARTY_CACHE.
5. Edita el valor de PS_SMARTY_FORCE_COMPILE y cámbialo a 2 (para forzar la recompilación) o 0, y asegúrate de que PS_SMARTY_CACHE esté en 0 (desactivado temporalmente).
6. Guarda los cambios y limpia la caché nuevamente como se indicó en el Método 1.

Método 3: Revisar el modo depuración (Debug)

Para identificar exactamente qué archivo .tpl está generando la excepción, es útil activar el modo desarrollador:

1. Accede vía FTP a la ruta /config/ de tu PrestaShop.
2. Abre el archivo defines.inc.php.
3. Busca la línea que define _PS_MODE_DEV_ y cámbiala de false a true.
4. Guarda el archivo y recarga la página con el error. Ahora verás un mensaje detallado con la traza exacta del error de Smarty (Stack Trace), indicando el archivo exacto que debes corregir.