Activar modo Debug en PrestaShop: Localiza errores fácilmente

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

Si alguna vez has visto una página en blanco en tu tienda, un error 500 o un mensaje críptico que no entiendes, sabes lo frustrante que puede ser. La mayoría de las veces, PrestaShop oculta los errores reales para proteger tu tienda y a tus clientes. Pero cuando algo falla, necesitas ver qué está pasando exactamente. Ahí es donde entra el modo debug PrestaShop.

Activar el modo debug es como abrir el capó de tu coche: te permite ver el motor, las piezas y encontrar la avería. En lugar de ver una página en blanco, verás un mensaje detallado con la línea exacta del archivo que causa el problema. Esto es esencial para que tú o tu equipo técnico puedan solucionar cualquier error rápidamente.

En este artículo te explicaré paso a paso cómo activar el modo debug en PrestaShop, tanto en versiones modernas (1.7 y 8.x) como en versiones antiguas (1.6 y anteriores). También te contaré cómo desactivarlo correctamente y qué errores comunes puedes encontrar.

¿Qué es exactamente el modo debug en PrestaShop?

El modo debug es una funcionalidad interna de PrestaShop que muestra información detallada sobre errores, advertencias y avisos en pantalla. Cuando está activado, verás:

El mensaje de error específico.
El archivo y la línea exacta donde ocurre el problema.
La traza o pila de llamadas (stack trace).
El entorno de ejecución (versión de PHP, versión de PrestaShop, etc.).

Esto es fundamental para diagnosticar problemas como módulos incompatibles, errores de tema, problemas de base de datos o conflictos de caché. Sin el modo debug, solo verías un "Error 500" o una página en blanco, que no te dice nada útil.

[INFO] El modo debug NO es para uso permanente en producción. Solo debes activarlo mientras estás resolviendo un problema y desactivarlo inmediatamente después. Dejarlo activo en una tienda pública puede exponer información sensible sobre tu servidor y tu código.

Antes de empezar: haz una copia de seguridad

Esta es la regla de oro en cualquier modificación técnica. Antes de tocar archivos de configuración, haz siempre una copia de seguridad de tu tienda. Al menos, de los archivos que vas a modificar.

En este caso, vas a editar el archivo config/defines.inc.php. Si algo sale mal, necesitas poder restaurar la versión original.

[WARNING] Si no tienes experiencia editando archivos, este proceso requiere acceso a tu servidor mediante FTP o al administrador de archivos de tu panel de hosting. Si usas Syspanel (el panel de control de tu hosting, que se accede por el puerto 2106), puedes usar el administrador de archivos integrado para editar el archivo sin necesidad de FTP.

Cómo activar el modo debug en PrestaShop 1.7 y 8.x

Las versiones modernas de PrestaShop (1.7, 8.0 y superiores) tienen un sistema de constantes de configuración en el archivo config/defines.inc.php. Sigue estos pasos:

Paso 1: Accede a tu servidor

Necesitas acceder a los archivos de tu instalación de PrestaShop. Puedes hacerlo de dos maneras:

Mediante FTP: Usa un cliente como FileZilla y conéctate con tus credenciales FTP.
Mediante el administrador de archivos de Syspanel: Entra a Syspanel (recuerda, el puerto es el 2106) y busca la sección "Archivos" o "Administrador de archivos".

Paso 2: Localiza el archivo defines.inc.php

Dentro de la carpeta raíz de tu PrestaShop, busca la carpeta config. Dentro de ella, encontrarás el archivo defines.inc.php. Es un archivo PHP que contiene todas las constantes de configuración.

Paso 3: Edita el archivo

Abre el archivo con un editor de texto (no uses el bloc de notas de Windows, mejor algo como Notepad++ o el editor del propio administrador de archivos). Busca la siguiente línea:

define('_PS_MODE_DEV_', false);

Esta línea es la que controla el modo debug. Cámbiala de false a true:

define('_PS_MODE_DEV_', true);

Guarda el archivo y súbelo de nuevo a tu servidor si lo editaste localmente.

Paso 4: Verifica que funciona

Ahora, recarga la página que te daba el error. Deberías ver un mensaje detallado con el error exacto. Si no ves nada, prueba a vaciar la caché de PrestaShop desde el panel de administración (Parámetros avanzados > Rendimiento > Vaciar caché).

Cómo activar el modo debug en PrestaShop 1.6 y versiones anteriores

Las versiones antiguas de PrestaShop (1.6 y anteriores) tienen un sistema similar, pero con una diferencia importante: también puedes activarlo desde el propio panel de administración.

Opción A: Desde el panel de administración

Entra en tu panel de administración de PrestaShop.
Ve a Parámetros avanzados > Rendimiento.
Busca la opción "Depuración" o "Debug".
Cambia la opción de "No" a "Sí" o marca la casilla "Activar el modo de depuración".
Guarda los cambios.

Opción B: Editando el archivo defines.inc.php

Si no puedes acceder al panel de administración (por ejemplo, si la tienda está completamente caída), sigue el mismo proceso que en la sección anterior:

Accede a tu servidor.
Ve a config/defines.inc.php.
Busca la línea define('_PS_MODE_DEV_', false); y cámbiala a true.
Guarda y sube el archivo.

[TIP] En PrestaShop 1.6, a veces hay dos constantes relacionadas: _PS_MODE_DEV_ y _PS_DISPLAY_COMPATIBILITY_WARNING_. Si no ves errores, prueba a activar ambas para obtener más información.

¿Qué errores puedes ver con el modo debug activado?

Una vez activado, verás errores de diferentes tipos. Aquí tienes los más comunes:

Error de PHP (Parse error): Indica un error de sintaxis en un archivo. Verás algo como Parse error: syntax error, unexpected '}' in /ruta/al/archivo.php on line 45.
Error fatal (Fatal error): Un error crítico que detiene la ejecución. Por ejemplo: Fatal error: Uncaught Error: Call to undefined function....
Aviso (Warning): No detiene la ejecución, pero indica un problema potencial. Por ejemplo: Warning: session_start(): Cannot start session when headers already sent.
Nota (Notice): Aviso menor de PHP. A veces es inofensivo, pero puede indicar malas prácticas de código.

Con esta información, puedes buscar el error en Google o contactar con tu soporte técnico con el mensaje exacto. Esto ahorra muchísimo tiempo.

Cómo desactivar el modo debug (paso importante)

Una vez que hayas identificado y solucionado el error, debes desactivar el modo debug inmediatamente. Dejarlo activo es un riesgo de seguridad.

Para desactivarlo:

Vuelve a abrir el archivo config/defines.inc.php.
Cambia define('_PS_MODE_DEV_', true); de vuelta a false.
Guarda y sube el archivo.
Vacía la caché desde el panel de administración.

[WARNING] Si olvidas desactivar el modo debug, cualquier visitante de tu tienda podría ver información sensible sobre tu servidor, como rutas de archivos, versiones de software y posibles vulnerabilidades. Esto facilita que un atacante comprometa tu tienda.

Preguntas frecuentes sobre el modo debug en PrestaShop

¿Activar el modo debug afecta al rendimiento de mi tienda?

Sí, ligeramente. El modo debug consume más recursos porque PHP muestra más información y no cachea ciertos datos. Por eso es solo para diagnóstico temporal.

¿Puedo activar el modo debug sin acceso al panel de administración?

Sí, siempre que tengas acceso a los archivos del servidor (FTP o administrador de archivos). Es la opción más común cuando la tienda está completamente caída.

¿Qué hago si veo un error y no sé cómo solucionarlo?

Anota el mensaje de error completo y búscalo en Google o en los foros de PrestaShop. También puedes contactar con tu proveedor de hosting o con un desarrollador especializado en PrestaShop. El mensaje de error del modo debug es oro puro para que te ayuden rápido.

¿Por qué no veo ningún error aunque el modo debug está activo?

Puede que el error esté relacionado con la base de datos o con la caché. Prueba a vaciar la caché y a desactivar la caché de Smarty temporalmente. Si el problema persiste, revisa los logs del servidor (en Syspanel puedes encontrar los logs de errores en la sección "Registros").

¿El modo debug funciona igual en PrestaShop 9?

PrestaShop 9 es la versión más reciente y mantiene la misma filosofía, aunque la estructura de archivos puede variar ligeramente. El archivo config/defines.inc.php sigue existiendo, así que el método es el mismo. Si tienes dudas, consulta la documentación oficial de tu versión.

Consejos finales para gestionar errores en PrestaShop

Activar el modo debug PrestaShop es el primer paso para resolver cualquier problema técnico. Pero no es la única herramienta que tienes a tu disposición:

Revisa los logs de tu servidor: Syspanel te ofrece acceso a los logs de error de PHP y del servidor web. Ahí encontrarás información detallada incluso sin activar el modo debug.
Usa herramientas de diagnóstico: PrestaShop tiene un módulo de diagnóstico llamado "Health Check" o "Comprobación de salud" que revisa los requisitos del sistema.
Mantén todo actualizado: Las versiones antiguas de PrestaShop y PHP son más propensas a errores. Actualizar a la última versión estable de PrestaShop y PHP (8.1 o superior) reduce drásticamente los problemas.
Haz copias de seguridad periódicas: Si algo falla, poder restaurar una copia limpia te salva de muchos dolores de cabeza.

[TIP] Si trabajas con Syspanel (acceso por el puerto 2106), aprovecha la función de copias de seguridad automáticas. Tener una copia reciente antes de cualquier modificación es la mejor práctica.

Conclusión

Activar el modo debug PrestaShop es una tarea sencilla pero muy poderosa. Te permite ver los errores PrestaShop que normalmente están ocultos, identificar la causa raíz de un problema y solucionarlo en minutos en lugar de horas de prueba y error.

Recuerda los pasos clave:

Haz una copia de seguridad.
Edita config/defines.inc.php y cambia _PS_MODE_DEV_ a true.
Identifica el error y solucionalo.
Cambia _PS_MODE_DEV_ de vuelta a false.
Vacía la caché.

Con esta guía, ya tienes todo lo necesario para diagnosticar y resolver los errores de tu tienda como un profesional. Si tienes dudas, no dudes en contactar con tu soporte técnico o con la comunidad de PrestaShop. ¡Buena suerte!