Cómo activar el modo debug en PrestaShop: 2 métodos

El modo debug de PrestaShop muestra mensajes de error detallados en lugar de una pantalla en blanco o un error genérico, lo que permite identificar exactamente qué plugin, tema o línea de código está causando el problema. Es la primera herramienta a activar cuando la tienda muestra errores, deja de cargar o se comporta de forma inesperada.

Hay dos formas principales de activarlo: desde el propio panel de administración (si todavía es accesible) o editando directamente el archivo de configuración del servidor (cuando el Back Office tampoco carga). Ambos métodos son válidos para PrestaShop 1.6, 1.7 y 8.x.

⚠️ El modo debug nunca debe dejarse activo en una tienda en producción. Muestra información técnica interna que puede ser aprovechada por terceros. Actívalo solo para diagnosticar el problema, y desactívalo en cuanto hayas identificado el error.

Método 1 — Desde el Back Office de PrestaShop

Este es el método más rápido si todavía puedes acceder al panel de administración.

PrestaShop 1.6 y 1.7

1. Accede al Back Office de tu tienda (por ejemplo, https://tutienda.com/admin).
2. Ve a Parámetros Avanzados → Rendimiento.
3. En la sección Modo Debug, activa la opción «Activar modo depuración».
4. Guarda los cambios.

PrestaShop 8.x

1. Accede al Back Office.
2. Ve a Configuración Avanzada → Rendimiento (la sección se renombró en PS 8).
3. En el apartado Depuración, activa el modo debug.
4. Guarda los cambios.

Si tras activarlo desde el Back Office sigues sin ver mensajes de error, prueba el Método 2 directamente en el archivo de configuración.

Método 2 — Editando el archivo defines.inc.php

Si el Back Office no carga (pantalla en blanco, error 500 o error de PHP), debes activar el debug directamente en el servidor. Para ello necesitas acceso por FTP/SFTP o mediante el Administrador de Archivos de cPanel.

1. Conéctate vía FTP/SFTP o abre el Administrador de Archivos de tu panel de hosting.
2. Navega hasta el archivo /config/defines.inc.php en la raíz de tu instalación de PrestaShop.
3. Edita el archivo y localiza esta línea (habitualmente cerca del principio del archivo):

   define('PS_MODE_DEV', false);

4. Cambia false por true:

   define('PS_MODE_DEV', true);

5. Guarda el archivo.

Recarga la página problemática en el navegador — ahora deberías ver el mensaje de error detallado en lugar de la pantalla en blanco.

⚠️ Recuerda volver a cambiar true por false en cuanto hayas identificado y resuelto el error.

Si el modo debug está activo pero no aparecen errores: borra la caché

Si después de activar el modo debug el problema sigue sin mostrarse, es probable que PrestaShop esté sirviendo páginas en caché. Borra la caché por cualquiera de estos métodos:

Desde el Back Office

Ve a Parámetros Avanzados → Rendimiento → Borrar caché y haz clic en el botón de limpiar.

Desde el servidor (PrestaShop 1.7 y 8.x)

Elimina manualmente el contenido de la carpeta /var/cache/ dentro de tu instalación de PrestaShop, manteniendo la carpeta pero vaciando su contenido. Puedes hacerlo por FTP o desde el Administrador de Archivos de cPanel.

Desde el servidor (PrestaShop 1.6)

Vacía el contenido de las carpetas /cache/smarty/compile/ y /cache/smarty/cache/.

Cómo desactivar el modo debug cuando termines

Una vez identificado y resuelto el error, es imprescindible desactivar el modo debug antes de que la tienda vuelva a recibir visitas. Con el debug activo, cualquier visitante puede ver los mensajes de error con rutas internas, versiones de software y otra información técnica sensible.

Desde el Back Office

Ve a la misma ruta donde lo activaste (Parámetros Avanzados → Rendimiento → Modo Debug) y desactiva la opción. Guarda los cambios.

Desde el archivo defines.inc.php

Abre /config/defines.inc.php y cambia de nuevo la línea:

define('PS_MODE_DEV', true);

a:

define('PS_MODE_DEV', false);

Guarda el archivo.

Errores frecuentes al activar el modo debug en PrestaShop

Pantalla en blanco incluso con el modo debug activado

Puede deberse a un error de PHP tan grave que impide mostrar cualquier salida, o a que la caché sigue sirviendo páginas antiguas. Prueba a limpiar la caché (carpeta /var/cache/) y recarga. Si sigue en blanco, verifica el log de errores de PHP desde cPanel (Métricas → Registro de errores) o directamente en el archivo error_log en la raíz de tu hosting.

El archivo defines.inc.php no existe en la ruta indicada

Verifica que estás buscando en la raíz correcta de tu instalación de PrestaShop. Si tienes PrestaShop instalado en un subdirectorio (por ejemplo /public_html/tienda/), la ruta completa sería /public_html/tienda/config/defines.inc.php.

No tengo acceso al Back Office ni a FTP

Si no puedes acceder por ninguno de los dos métodos anteriores, usa el Terminal de cPanel (cPanel → Avanzado → Terminal) para editar el archivo directamente:

nano /home/USUARIO_CPANEL/public_html/config/defines.inc.php

Sustituye USUARIO_CPANEL y la ruta por los valores correctos de tu instalación.

Los errores aparecen pero no se entienden

PrestaShop en modo debug muestra el tipo de error, el archivo y la línea donde se produce. Los errores más frecuentes son de tipo Fatal error (PHP incapaz de continuar, habitualmente un plugin o theme mal codificado), Warning (problema no fatal, la página puede cargar igualmente) y Notice (advertencia informativa, generalmente no crítica). Busca el mensaje del Fatal error y el nombre del archivo indicado — casi siempre apunta al módulo o tema que está causando el problema.

El modo debug muestra errores de módulos que no uso

PrestaShop carga algunos módulos en segundo plano aunque no estén visibles en el frontend. Si el error apunta a un módulo instalado pero inactivo, desinstálalo completamente desde el gestor de módulos del Back Office y comprueba si el error desaparece.

Preguntas frecuentes sobre el modo debug de PrestaShop

¿El modo debug afecta al funcionamiento de la tienda para los clientes?

Sí. Con el modo debug activo, cualquier visitante verá los mensajes de error técnico en lugar de la página normal. Además, en algunos casos puede ralentizar la tienda. Por eso debe usarse exclusivamente para diagnóstico y desactivarse inmediatamente después.

¿Es diferente el procedimiento en PrestaShop 8 respecto a 1.7?

El procedimiento es prácticamente idéntico. La principal diferencia en PS 8 es que la sección del Back Office se llama Configuración Avanzada en lugar de Parámetros Avanzados. El archivo defines.inc.php y la variable PS_MODE_DEV funcionan igual en ambas versiones.

¿Puedo activar el modo debug solo para mi IP y no para los clientes?

PrestaShop no tiene esta funcionalidad de forma nativa. La forma más habitual de diagnosticar sin afectar a los clientes es poner la tienda en modo mantenimiento (Parámetros de la Tienda → General → Modo Mantenimiento), con tu IP en la lista blanca, y entonces activar el debug. Así solo tú ves la tienda y los errores.

¿Dónde se guardan los logs de error de PrestaShop?

PrestaShop guarda logs de errores en dos lugares: en el Back Office en Configuración Avanzada → Logs (donde puedes configurar el nivel de severidad que se registra), y en los logs del servidor que puedes consultar desde cPanel → Métricas → Registro de Errores. El modo debug muestra los errores directamente en pantalla, pero los logs del servidor son útiles para errores que ocurren en segundo plano o en tareas cron.

¿Qué hago si el error apunta a un archivo del core de PrestaShop?

Si el error no apunta a un módulo ni a un tema sino a un archivo del núcleo de PrestaShop (carpetas /classes/, /controllers/, /src/), las causas más habituales son: (1) archivos del core modificados o corruptos — considera reinstalar PrestaShop manteniendo la base de datos; (2) incompatibilidad entre la versión de PHP del servidor y la versión de PrestaShop instalada — verifica en cPanel que la versión de PHP es compatible con tu versión de PrestaShop.