Si alguna vez tu tienda online ha dejado de funcionar de repente o te ha mostrado una pantalla en blanco, seguramente te has preguntado qué está fallando y cómo solucionarlo. La realidad es que, sin un mensaje de error claro, encontrar el problema puede ser complicado.
Aquí es donde entra en juego el modo DEBUG en PrestaShop. Esta opción permite ver los errores ocultos en el código, ayudando a detectar el motivo del fallo y a corregirlo rápidamente.
En esta guía te explicamos cuándo y cómo activarlo, además de algunos consejos importantes para evitar problemas de seguridad y solucionar errores frecuentes.
Tabla de Contenidos
- Cuándo debemos activar el modo DEBUG o Depuración de PrestaShop
- Habilitando el modo DEBUG de errores
- Cómo desactivar DEBUG de forma segura
- Si DEBUG no muestra errores, ¿qué hacer?
- Cómo activar DEBUG sin afectar a los clientes
- Errores comunes y cómo solucionarlos
- Alternativas al modo DEBUG para producción
- Hosting PrestaShop en Loading
- Conclusión
Cuándo debemos activar el modo DEBUG o Depuración de PrestaShop
El modo DEBUG no debe estar siempre activado, pero es útil en situaciones como estas:
- Pantalla en blanco o error 500 → Indica un problema grave en el código.
- Fallos en el carrito de compra o en el pago → Puede deberse a un conflicto con módulos o configuraciones.
- Un módulo ha dejado de funcionar → A veces, las actualizaciones pueden causar errores inesperados.
- La web carga muy lenta o tiene comportamientos extraños → Puede ser un error en el servidor o en la base de datos.
Si te encuentras en alguna de estas situaciones, sigue leyendo para saber cómo activar DEBUG y solucionar el problema.
A veces nuestra página nos da problemas y no sabemos de dónde vienen, activando este modo podremos ver la causa de los fallos y así repararlos.
Habilitando el modo DEBUG de errores
- Necesitaremos editar el archivo defines.inc.php que encontraremos en la carpeta /config/ de nuestra instalación de Prestashop. Para ello accederemos a nuestro FTP mediante un programa de clientes FTP como por ejemplo Filezilla, o también podremos hacerlo desde el panel de administración de nuestro hosting (en este caso plesk) pinchando en «Administrador de archivos».
- En el archivo defines.inc.php buscaremos la siguiente línea de código:
define('_PS_MODE_DEV_', false);
Y la cambiaremos por esta otra:
define('_PS_MODE_DEV_', true);
- Guardamos el archivo y lo sobreescribimos. Ahora se nos mostrarán los errores en pantalla y podremos repararlos.
Cuando hayas reparado los errores recuerda volver a desactivar de nuevo el modo DEBUG de tu Prestashop.
Cómo desactivar DEBUG de forma segura
Una vez que hayas solucionado el problema, es fundamental desactivar el modo DEBUG para evitar que los errores sean visibles para todos los visitantes.
Para ello, simplemente vuelve a editar el archivo defines.inc.php y cambia la línea:define(‘_PS_MODE_DEV_’, true);
por esta otra:define(‘_PS_MODE_DEV_’, false);
Además, te recomendamos vaciar la caché de PrestaShop desde el panel de administración en Parámetros Avanzados > Rendimiento, o eliminando manualmente los archivos en la carpeta /var/cache/.
Si DEBUG no muestra errores, ¿qué hacer?
A veces, incluso con el modo DEBUG activado, los errores no aparecen en pantalla. Esto puede deberse a varios motivos:
- Errores bloqueados por el servidor → Algunos hostings ocultan los errores críticos. Puedes revisarlos en el archivo de logs de Apache:
- En Plesk: Registros > error.log
- Por FTP:
/var/log/apache2/error.log
- Bloqueo por un firewall o módulo de seguridad → Algunos sistemas de seguridad pueden evitar que los errores se muestren en pantalla.
- Error interno de PrestaShop → En ocasiones, la tienda puede quedar en un estado donde ni siquiera DEBUG funciona. En este caso, revisa si puedes acceder al back office y desactivar módulos sospechosos.
Cómo activar DEBUG sin afectar a los clientes
Si tu tienda sigue activa y solo quieres ver los errores desde tu IP, puedes limitar el acceso al modo DEBUG.
Añade este código en el archivo .htaccess, reemplazando TU_IP por tu dirección IP real:
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{REMOTE_ADDR} !^TU_IP$
RewriteRule .* - [F,L]
</IfModule>Con esto, solo tu IP podrá ver los errores mientras el resto de los usuarios navega sin interrupciones. Para saber cuál es tu dirección IP real puedes acceder a nuestra herramienta.
Errores comunes y cómo solucionarlos
Aquí tienes algunos de los errores más frecuentes al activar DEBUG y sus soluciones:
| Error | Causa | Solución |
|---|---|---|
| Fatal error: Allowed memory size exhausted | PrestaShop ha alcanzado el límite de memoria permitido. | Aumenta el `memory_limit` en `php.ini` a 512M o más. |
| Call to undefined function | Falta una extensión de PHP necesaria. | Activa la extensión en el panel de control del hosting (Plesk). |
| 500 Internal Server Error | Error en permisos de archivos o módulos incompatibles. | Asegura que los permisos sean 755 para carpetas y 644 para archivos. |
Alternativas al modo DEBUG para producción
Si no quieres activar DEBUG en un entorno en vivo, puedes probar otras opciones más seguras:
- Activar logs en PrestaShop → Desde el panel de administración en Parámetros Avanzados > Registro.
- Usar herramientas externas como New Relic o Blackfire.io para monitorear fallos sin exponer información en pantalla.
- Crear una copia de seguridad antes de hacer cambios, para evitar problemas si algo sale mal.
Hosting PrestaShop en Loading
Si buscas un hosting optimizado para PrestaShop, en Loading tenemos todo lo que necesitas para que tu tienda online funcione rápida, segura y sin complicaciones.
Somos un hosting recomendado por PrestaShop, lo que garantiza que nuestros servidores están configurados para ofrecer el mejor rendimiento en esta plataforma. Además, contarás con soporte técnico especializado 24/7 en español, listo para ayudarte con cualquier problema o duda, ya sea por teléfono, chat o ticket.
¿Por qué elegir Loading para tu tienda PrestaShop?
✔️ Migración gratuita → Si ya tienes tu tienda en otro proveedor, la trasladamos por ti sin interrupciones.
✔️ Copias de seguridad diarias → Evita pérdidas de datos con nuestras copias automáticas.
✔️ Máxima velocidad → Servidores con discos SSD NVMe y optimización avanzada para PrestaShop.
✔️ Seguridad garantizada → Protección contra malware, antivirus y certificado SSL gratuito.
✔️ Infraestructura en España → IP española y centro de datos en Alicante para mejorar el SEO y la velocidad de carga.
Si quieres una tienda online rápida, segura y con soporte experto, prueba nuestro hosting PrestaShop y olvídate de los problemas técnicos.
Conclusión
El modo DEBUG de PrestaShop es una herramienta muy útil para detectar y solucionar errores en tu tienda online. Sin embargo, es importante usarlo con precaución y recordar desactivarlo después de su uso.
Si los errores persisten, revisa los logs del servidor, ajusta los permisos de archivos o prueba herramientas de monitoreo avanzadas. Con estos consejos, tendrás más control sobre tu tienda y evitarás problemas que puedan afectar las ventas.
Si quieres, también puedes encontrar un módulo específico para activar y desactivar el modo debug en PrestaShop. En la web de addons oficial seguro que encuentras varias opciones, aunque la mayoría serán de pago.