Diagnóstico

Modo debug en PrestaShop: cómo activarlo para ver el error real (y desactivarlo después)

Cuando PrestaShop falla, lo normal es ver una página en blanco o un «error 500» que no dice nada. El modo debug (en el panel, «Modo depuración») hace que la tienda enseñe el error real: el fichero y la línea. Aquí tienes cómo activarlo desde el panel o, si no puedes entrar, desde un fichero, y por qué hay que apagarlo al terminar. Vale para la 1.7, la 8 y la 9.

Guía técnicaLectura ~5 minPublicado el
En esta guía7 apartados
  1. Para qué sirve
  2. Activarlo desde el panel
  3. Si no puedes entrar al panel
  4. En la 9: solo para ti
  5. Desactivarlo al terminar
  6. ¿Lo miramos nosotros?
  7. Preguntas frecuentes

Para qué sirve

Con el modo debug activado, PrestaShop enseña en pantalla los errores de PHP (con el fichero y la línea) y los de las consultas a la base de datos. Es la forma más rápida de pasar de «la tienda no va» a «falla este módulo en esta línea». Mientras está activo, la tienda trabaja con su propia caché, en var/cache/dev, en lugar de la normal, var/cache/prod.

Activarlo desde el panel

  1. Entra en Parámetros Avanzados → Rendimiento.
  2. En el bloque «Modo depuración», pon «Modo depuración» en «Sí» y guarda.
  3. Vuelve a la página que falla y recárgala: el error aparece en pantalla.

En ese mismo bloque está «Desactivar todos los métodos overrides», útil para descartar que el fallo venga de un retoque hecho sobre el código de PrestaShop. Si lo usas, vuelve a dejarlo como estaba.

Si no puedes entrar al panel

Si el panel también falla, se activa en un fichero, por FTP o con el administrador de archivos del alojamiento. Haz antes una copia del fichero.

  1. Abre config/defines.inc.php.
  2. Busca la línea define('_PS_MODE_DEV_', false); y cambia false por true.
  3. Guarda y recarga la página que falla.
define('_PS_MODE_DEV_', true);

Ojo con config/defines_custom.inc.php. Si ese fichero existe y define _PS_MODE_DEV_, manda él: cambiar defines.inc.php no hará nada. Es también el fichero en el que escribe el interruptor del panel cuando existe.

En la 9: solo para ti

Desde la 9, en Parámetros Avanzados → Rendimiento hay dos campos más: «Nombre de la cookie de depuración» y, opcional, «Valor de la cookie de depuración». Si los rellenas, el modo depuración solo se activa en el navegador que lleve esa cookie, y tus clientes siguen viendo la tienda normal. Para ponerte la cookie, abre la consola del navegador (F12) en tu tienda y escribe, con el nombre y el valor que hayas elegido:

document.cookie = "nombre=valor; path=/";

Y si actualizas módulos por consola en la 9, hazlo con --no-debug: en modo depuración, la consola convierte cualquier aviso en error y la actualización se para a medias. Nos pasó actualizando una tienda.

Desactivarlo al terminar

Si con el modo debug sigues sin ver nada, el error está en los registros del servidor o de PrestaShop: dónde mirar según tu versión, en la guía del error 500, y si lo que ves es una página en blanco, en pantalla en blanco.

¿Ves el error y no sabes qué hacer con él?

Mándanos la dirección y el mensaje que sale, y lo miramos. Si la tienda está caída, empezamos el mismo día laborable en que tenemos acceso.

Escribir por WhatsApp o pide tu Radiografía gratis

Preguntas frecuentes

¿Cómo activo el modo debug en PrestaShop?
En Parámetros Avanzados → Rendimiento, pon «Modo depuración» en «Sí» y guarda. Si no puedes entrar al panel, en config/defines.inc.php cambia define('_PS_MODE_DEV_', false); por true. Si existe config/defines_custom.inc.php y lo define, cámbialo ahí, que es el que manda.
¿Cómo desactivo el modo debug de PrestaShop?
Igual que se activa, pero al revés: «Modo depuración» en «No» en Parámetros Avanzados → Rendimiento, o _PS_MODE_DEV_ a false en el fichero. Después vacía la caché.
¿Puedo activar el modo debug solo para mí?
En la 9 sí: en Parámetros Avanzados → Rendimiento, rellena «Nombre de la cookie de depuración» (y, si quieres, su valor). El modo depuración solo se activa en el navegador que lleve esa cookie. En la 1.7 y la 8 no existe esa opción.
¿Es peligroso dejar el modo debug activado?
Sí. Enseña a cualquier visitante rutas y datos internos del servidor cuando algo falla, y la tienda va más lenta porque trabaja con otra caché y sin optimizar. Úsalo para ver el error y apágalo al terminar.

Comprobado el 2 de noviembre de 2026 en el código de PrestaShop: qué fichero cambia el interruptor, qué hace el modo depuración y la cookie de depuración de la 9. Los nombres del panel, en la 1.7, la 8 y la 9 en español.

← Volver al blog

Escribir por WhatsApp