Activar modo debug en PrestaShop | Ver errores

¿Por qué necesitas activar el modo debug en PrestaShop?

Cuando tu tienda online da un error, lo normal es ver una pantalla blanca o un mensaje genérico como "Error: Este sitio web no está disponible". Eso es frustrante, sobre todo si estás intentando arreglar algo. La solución es activar el modo debug de PrestaShop, que muestra los errores reales que ocurren en el código, en la base de datos o en los módulos.

Este modo es una herramienta de diagnóstico. En lugar de ocultar el problema, PrestaShop lo muestra con detalles técnicos: la línea exacta del archivo, la consulta SQL fallida o la función que está fallando. Con esa información, tú o tu desarrollador podéis corregir el error mucho más rápido.

En este artículo te explico paso a paso cómo hacerlo, tanto si tienes acceso al panel de administración como si solo puedes acceder a los archivos del servidor. No necesitas ser un experto, solo seguir las instrucciones con calma.

¿Qué es el modo debug en PrestaShop?

El modo debug (o modo depuración) es una funcionalidad de PrestaShop que cambia la forma en que la tienda trata los errores. Cuando está desactivado, el sistema intenta "ocultar" los fallos mostrando una página genérica. Cuando lo activas, verás:

El mensaje de error específico.
El archivo y la línea exacta donde ocurre el error.
La traza completa de ejecución (stack trace).
Posibles avisos de compatibilidad con PHP.

Esto es esencial para diagnosticar problemas de configuración, módulos incompatibles, errores de tema o conflictos con el servidor.

Método 1: Activar modo debug desde el panel de administración

Esta es la forma más sencilla y la que recomiendo si aún puedes acceder a tu back-office.

Paso 1: Accede a tu panel de administración

Entra en tu tienda como administrador. La URL suele ser algo así: www.tutienda.com/admin1234 (el nombre de carpeta lo elegiste al instalar).

Paso 2: Ve al menú de Parámetros avanzados

En el menú lateral izquierdo, busca la sección Parámetros avanzados. Dentro de ella, haz clic en Rendimiento.

Paso 3: Localiza la opción de depuración

Dentro de la página de Rendimiento, baja hasta encontrar el apartado Depuración. Ahí verás una opción llamada Modo de depuración. Tiene tres valores posibles:

Desactivado: es el valor por defecto. No verás errores.
Solo para mi IP: muestra los errores solo a tu dirección IP. Es la opción más segura para trabajar sin que los clientes vean mensajes raros.
Activado: muestra errores a todo el mundo. Úsalo solo en entornos de desarrollo o durante unos minutos.

Selecciona Solo para mi IP si quieres ver el error pero sin exponer información sensible a tus clientes. Si necesitas ayuda para saber cuál es tu IP, puedes buscarla en Google con "cuál es mi IP".

Paso 4: Guarda los cambios

Haz clic en Guardar al final de la página. La tienda se recargará y, si hay algún error, ahora lo verás claramente.

[TIP]
Si no encuentras la opción de depuración, asegúrate de que tu PrestaShop esté actualizado. En versiones antiguas (1.6 o anteriores) la ruta puede variar ligeramente, pero siempre está dentro de Parámetros avanzados.

Método 2: Activar modo debug editando el archivo defines.inc.php

Si no puedes acceder al panel de administración (por ejemplo, porque la tienda te muestra un error fatal), tendrás que editar un archivo manualmente. No te asustes, es un proceso sencillo.

Paso 1: Accede a los archivos de tu tienda

Necesitas un gestor de archivos. Si tu hosting usa Syspanel, entra en el panel con el puerto 2106 (por ejemplo: https://tudominio.com:2106). Dentro, busca el gestor de archivos o usa el acceso FTP si lo prefieres.

Paso 2: Localiza la carpeta config

Dentro del directorio raíz de tu PrestaShop (normalmente public_html o www), busca la carpeta llamada config. Dentro de ella está el archivo defines.inc.php.

Paso 3: Edita el archivo defines.inc.php

Haz clic derecho sobre el archivo y selecciona Editar (o descárgalo y edítalo con un editor de texto como Notepad++). Busca las siguientes líneas:

define('_PS_MODE_DEV_', false);
define('_PS_MODE_DEV_DEBUG_', false);

Paso 4: Cambia los valores a true

Para activar el modo debug, cambia ambos valores a true. Debería quedar así:

define('_PS_MODE_DEV_', true);
define('_PS_MODE_DEV_DEBUG_', true);

Guarda el archivo y súbelo de nuevo si lo habías descargado. Si lo editaste directamente, simplemente guarda y cierra.

[WARNING]
No dejes el modo debug activado para siempre. Una vez hayas resuelto el error, vuelve a poner los valores en false. Tener el modo debug activado en producción puede exponer información sensible (rutas de archivos, contraseñas de base de datos, etc.) a cualquier visitante.

Método 3: Activar modo debug solo para tu IP (avanzado)

Si quieres ver los errores solo cuando tú accedes a la tienda, puedes combinar el método anterior con una condición de IP. Edita el archivo defines.inc.php y sustituye el bloque anterior por este código:

if (isset($_SERVER['REMOTE_ADDR']) && in_array($_SERVER['REMOTE_ADDR'], array('TU_IP_AQUI'))) {
    define('_PS_MODE_DEV_', true);
    define('_PS_MODE_DEV_DEBUG_', true);
} else {
    define('_PS_MODE_DEV_', false);
    define('_PS_MODE_DEV_DEBUG_', false);
}

Reemplaza TU_IP_AQUI por tu dirección IP real. Así, solo tú verás los errores y tus clientes seguirán viendo la tienda normal.

¿Qué errores puedes ver con el modo debug?

Una vez activado, verás mensajes como estos:

Error de conexión a la base de datos: "Link to database cannot be established".
Error de clase no encontrada: "Class 'MiModulo' not found".
Error de sintaxis en un archivo: "Parse error: syntax error, unexpected '}'".
Error de consulta SQL: "Duplicate column name 'id_product'".

Cada error te indica el archivo y la línea. Si no entiendes el mensaje, cópialo y búscalo en Google o en los foros de PrestaShop. Es muy probable que otro usuario haya tenido el mismo problema.

Cómo desactivar el modo debug correctamente

Cuando termines de solucionar el problema, es importante volver a poner todo en orden.

Si lo activaste desde el panel:

Entra de nuevo en Parámetros avanzados > Rendimiento y selecciona Desactivado en la opción de depuración. Guarda los cambios.

Si lo activaste editando defines.inc.php:

Abre el archivo y vuelve a poner los valores en false:

define('_PS_MODE_DEV_', false);
define('_PS_MODE_DEV_DEBUG_', false);

Guarda y listo.

[INFO]
Algunos módulos o temas pueden dejar archivos de caché antiguos. Si después de desactivar el modo debug sigues viendo errores, ve a Parámetros avanzados > Rendimiento y limpia la caché (botón "Vaciar la caché").

Preguntas frecuentes sobre el modo debug

¿Es peligroso activar el modo debug?

No es peligroso en sí, pero expone información técnica. Si lo activas en una tienda en producción, cualquier visitante podría ver rutas de archivos y consultas SQL. Por eso recomiendo usar la opción "Solo para mi IP" o activarlo solo durante unos minutos.

¿Por qué veo una página en blanco incluso con el modo debug activado?

Puede deberse a un error muy grave que impide que PrestaShop se cargue por completo. En ese caso, revisa el archivo config/defines.inc.php y asegúrate de que los valores estén correctamente cambiados. También puedes revisar los logs del servidor en Syspanel (puerto 2106) para ver el error real.

¿El modo debug afecta al rendimiento de mi tienda?

Sí, ligeramente. Generar trazas de error y mostrarlas en pantalla consume más recursos. Por eso solo debe estar activo durante el diagnóstico.

¿Puedo activar el modo debug sin acceso al panel ni a los archivos?

No, necesitas al menos uno de los dos accesos. Si no tienes ninguno, contacta con tu proveedor de hosting y pídeles que activen el modo debug temporalmente.

¿Qué hago si veo un error que no entiendo?

Copia el mensaje completo y búscalo en Google. También puedes consultar los foros de PrestaShop o preguntar en comunidades de desarrollo. Cuanta más información aportes (versión de PrestaShop, versión de PHP, módulos instalados), más fácil será que te ayuden.

Consejos finales

Activar el modo debug es una de las primeras cosas que debes hacer cuando tu tienda falla. Te dará pistas claras sobre qué está pasando y te ahorrará horas de adivinanzas. Eso sí, actívalo con cabeza y desactívalo cuando termines.

Si el error persiste y necesitas ayuda profesional, no dudes en contactar con un desarrollador especializado en PrestaShop. A veces un conflicto entre módulos o una mala configuración del servidor requiere un ojo experto.

Y recuerda: si tu hosting usa Syspanel, el acceso es por el puerto 2106. Ahí podrás gestionar archivos, bases de datos y logs sin problemas.

Espero que esta guía te haya sido útil. Si tienes alguna duda, déjala en los comentarios y la responderé encantado. ¡Buena suerte con tu tienda!