Modo debug en PrestaShop y registros: dónde leer el mensaje de error
El modo debug de PrestaShop se activa en Parámetros avanzados > Rendimiento o en el archivo config/defines.inc.php. Por sí solo no arregla nada. Muestra el mensaje de error en lugar de una página en blanco. Antes de activarlo, mira el registro en Parámetros avanzados > Registros. Muchas veces el mensaje de error ya está ahí, con la fecha y el nombre del módulo.
Autor: El equipo de TellMyShop. Una guía para dueños de tiendas PrestaShop: la causa, el arreglo manual y el mismo trabajo en una conversación con el chat.
Última actualización: · 5 min de lectura
¿Dónde guarda PrestaShop el mensaje de error?
En cuatro sitios, y cada uno ve errores un poco distintos.
| Sitio | Dónde encontrarlo | Qué guarda | Cuándo mirarlo |
|---|---|---|---|
| Registro de PrestaShop | Parámetros avanzados > Registros | entradas de PrestaShop y de los módulos con fecha y nivel de gravedad | siempre, el primero |
| Modo debug | Parámetros avanzados > Rendimiento o config/defines.inc.php | el mensaje completo con archivo y línea, en la propia página | cuando la página sale en blanco o da un error 500 |
| Archivos de registro en el servidor | la carpeta var/logs | errores escritos por la capa Symfony | cuando el panel no funciona o el error afecta al back office |
| Registro de errores del hosting | panel del hosting, normalmente «error log» o «registros PHP» | errores de PHP, incluidos los que PrestaShop no llegó a guardar | cuando el registro del panel está vacío |
Hay también un quinto sitio, la consola del navegador. Se abre con F12. Muestra errores de scripts, por ejemplo cuando un botón no hace nada y los registros de la tienda están vacíos. La pantalla de registros se describe en la documentación de PrestaShop.
¿Cómo se activa el modo debug con seguridad?
Durante el menor tiempo posible, mejor en una copia de prueba de la tienda.
- Revisa el registro. Si el mensaje de error ya está ahí, no necesitas el modo debug.
- Activa la depuración en el panel. Parámetros avanzados > Rendimiento, el interruptor del modo debug. Esta página se describe en la documentación de rendimiento.
- Si el panel no funciona, usa el archivo. En
config/defines.inc.phpcambia_PS_MODE_DEV_defalseatrue. Lo describe la documentación para desarrolladores. - Reproduce el error. Abre la página que falla y copia el mensaje entero: el texto, el archivo y el número de línea.
- Desactiva la depuración. Justo después de copiar el mensaje. El modo debug muestra detalles técnicos a cualquier visitante.
- Vacía la caché. Parámetros avanzados > Rendimiento, el botón de la esquina superior derecha.
Más interruptores, incluido desactivar los overrides y los módulos que no son de PrestaShop mientras dura la prueba, se describen en la guía de icomSEO sobre el modo debug (en polaco).
¿Cómo se lee una entrada del registro?
Mira tres cosas: el nivel de gravedad, la ruta del archivo y la fecha de la primera aparición.
El nivel de gravedad te dice lo urgente que es. El uno es información, el dos un aviso, el tres un error y el cuatro un problema grave que normalmente detiene la página. La ruta del archivo te dice de quién es el error. Un fragmento como modules/nombre_del_modulo apunta a un módulo, themes/ al tema y override/ a un override que dejó un módulo. La fecha de la primera aparición te dice qué cambió en ese momento. Un error que empezó un cuarto de hora después de actualizar un módulo suele venir de ese módulo.
Copia la entrada completa cuando se la mandes al autor del módulo o a un desarrollador. Añade la versión de PrestaShop, la versión de PHP y una descripción de lo que pulsas antes de que salga el error. Cuando la tienda ya da un error 500, pasa al plan del artículo error 500 en PrestaShop. Cuando el registro apunta a un módulo, mira cómo desactivar un módulo de PrestaShop sin perder sus datos.
¿Qué mensajes verás más a menudo?
En las tiendas PrestaShop se repiten unos cuantos tipos de mensajes, y cada uno da una pista de a quién pedir ayuda.
| Fragmento del mensaje | Qué suele significar | Quién puede ayudar |
|---|---|---|
| Allowed memory size exhausted | el script necesitó más memoria de la que permite el servidor | tu proveedor de hosting |
| Class not found | falta el archivo de una clase, a menudo tras quitar un módulo o por un override antiguo | un desarrollador |
| Undefined array key o Undefined index | el módulo no está adaptado a un PHP más nuevo, normalmente es un aviso | el autor del módulo |
| SQLSTATE | un error en una consulta a la base de datos, a menudo de un módulo | el autor del módulo o un desarrollador |
| Unable to load template | falta un archivo de plantilla en el tema o en un módulo | el autor del tema o un desarrollador |
Pega el mensaje completo en tu aviso. No lo acortes ni lo cuentes con otras palabras, porque el autor busca el texto exacto.
¿Cómo se revisa el registro con el chat?
Pides las entradas de un periodo, y tu chat (Claude o ChatGPT) agrupa los errores repetidos y los explica con palabras sencillas. También te dice a qué módulo apunta con más probabilidad cada error.
Tú: Saca los errores y problemas graves del registro desde el lunes, agrúpalos por mensaje y dime a qué módulo apuntan.
Tu chat: Desde el lunes hay 52 entradas de nivel error y ningún problema grave. Tres grupos:
41 entradas del módulo de opiniones, siempre en la página de producto, desde el martes por la mañana.
9 entradas del módulo de newsletter al suscribir una dirección, repartidas en el tiempo.
2 entradas sobre una imagen que falta en la categoría Faroles, un problema menor de contenido.
El primer grupo es el más urgente. Empezó después de actualizar el módulo de opiniones.
El modo debug está desactivado, y así debe seguir.
Leer el registro funciona en la versión gratuita TellMyShop Free, sin comprar nada. Por defecto abarca los últimos 7 días y hasta 200 entradas cada vez. Las direcciones de correo, los teléfonos y las direcciones IP aparecen enmascarados. La revisión técnica de la tienda también te avisa si alguien dejó el modo debug activado. Tienes una petición lista en el caso de uso entender los mensajes de error tras actualizar un módulo.
El chat no lee los archivos de la carpeta var/logs ni el registro de errores del hosting. Cuando la tienda no responde en absoluto, el módulo TellMyShop tampoco funciona, porque funciona dentro de la tienda.
Preguntas y respuestas
¿Dónde están los registros en PrestaShop?
En tres sitios. El registro del panel está en Parámetros avanzados > Registros y muestra las entradas guardadas por PrestaShop y los módulos. Los archivos de registro están en la carpeta var/logs del servidor. Los errores de PHP que PrestaShop no llegó a guardar están en el registro de errores del panel de tu hosting.
¿Puedo dejar el modo debug activado?
No lo dejes activado. El modo debug muestra detalles técnicos a cualquier visitante, incluidas las rutas de los archivos en el servidor. Además desactiva parte de la caché, así que la tienda va más lenta. Actívalo para el diagnóstico, mejor en una copia de prueba, y desactívalo justo después.
¿Qué significan los niveles de gravedad del registro de PrestaShop?
Las entradas tienen cuatro niveles. El uno es información, el dos un aviso, el tres un error y el cuatro un problema grave que normalmente detiene la página. En el día a día, mira los niveles tres y cuatro. Lee los avisos cuando algo se comporta de forma rara y el registro no tiene errores.
¿Cómo recibo avisos de errores por correo?
En Parámetros avanzados > Registros fijas el nivel de gravedad mínimo a partir del cual PrestaShop envía un correo al administrador. Ponlo en errores o problemas graves, o sea, tres o cuatro. Con el nivel de avisos tu bandeja se llena enseguida y los mensajes importantes se pierden entre los menores.
¿El chat lee los registros del servidor?
El chat lee el registro de PrestaShop del panel, por defecto de los últimos 7 días y hasta 200 entradas cada vez. Las direcciones de correo, los teléfonos y las direcciones IP aparecen enmascarados en los resultados. El chat no lee los archivos de var/logs ni el registro de errores del hosting. Esos los revisas en el panel del hosting o se los pides a tu proveedor.
PrestaShop es una marca registrada de PrestaShop SA. Claude es una marca de Anthropic PBC. ChatGPT y OpenAI son marcas de OpenAI. TellMyShop no está afiliado a estas empresas.