Un error 500 en PrestaShop significa que PHP ha fallado al generar la página y el servidor no sabe qué enseñar. La pantalla en blanco o el “Error 500” no dicen por qué, pero la causa casi siempre está escrita en un registro: en el de PrestaShop o en el de PHP de tu hosting. Lo que no hay que hacer es lo que hace casi todo el mundo: activar el modo depuración con la tienda abierta a todos los clientes, borrar módulos a ciegas o restaurar una copia sin saber qué ha pasado.
Abajo tienes dónde mirar, cómo leer el mensaje, cómo ver el error sin enseñárselo a tus clientes y qué arreglo corresponde a cada mensaje.
Cómo saber qué te está pasando
1. Mira hasta dónde llega el fallo. No es lo mismo que caiga toda la tienda que una sola página:
| Lo que ves | Dónde suele estar el problema |
|---|---|
| Toda la tienda y el back office dan 500 | El servidor: versión de PHP, base de datos, .htaccess, permisos |
| La tienda va, pero una página concreta da 500 | Un módulo o un override que actúa solo en esa página |
| Solo falla el back office, o una pantalla del back office | Un módulo de administración, o falta de memoria en esa pantalla |
| Falla al pagar o al confirmar el pedido | El módulo de pago o el de transporte |
| Falla solo al importar o al regenerar algo | Tiempo de ejecución o memoria |
2. Piensa qué ha cambiado en las últimas 24 horas. Un módulo instalado o actualizado, una actualización de PrestaShop, un cambio de versión de PHP que ha hecho el hosting, un archivo editado. Si hay un cambio, es el primer sospechoso.
3. Lee el registro. Hay dos, y conviene mirar los dos:
- El de PrestaShop, en la carpeta
var/logsde la tienda. Ordena por fecha y abre el archivo más reciente. Recoge los errores de la parte de PrestaShop que funciona sobre Symfony, sobre todo el back office. - El de PHP del hosting. En cPanel suele haber un archivo
error_logen la carpeta donde ha fallado el script, y un apartado de errores enMétricas. En otros paneles está enRegistrosoLogs. Si no lo encuentras, pídeselo al hosting: “el registro de errores de PHP de mi dominio de las últimas horas”.
Busca las líneas con PHP Fatal error o CRITICAL y la hora del fallo. La línea dice tres cosas: el mensaje, el archivo y el número de línea.

La ruta del archivo te dice quién ha fallado. Si el archivo está dentro de /modules/nombre/, es ese módulo. Si está en /override/, es un override. Si está en /themes/, es el tema. Si está en /classes/, /src/ o /vendor/, el fallo se ve en el núcleo, pero la causa suele estar en otro sitio: en la versión de PHP, en la memoria o en un módulo que le pasa datos que no espera.
Si no hay registro: ver el error sin enseñárselo a tus clientes
El consejo habitual es cambiar _PS_MODE_DEV_ a true en config/defines.inc.php. Funciona, pero enseña el error a todos los visitantes: rutas del servidor, consultas a la base de datos y, a veces, nombres de tablas. Y Google puede rastrear esas páginas mientras tanto.
Hay una forma mejor. PrestaShop carga el archivo config/defines_custom.inc.php antes que defines.inc.php, si existe (config.inc.php de PrestaShop 8.2). Y defines.inc.php solo define _PS_MODE_DEV_ si nadie lo ha definido antes (defines.inc.php). Así que puedes activar la depuración solo para tu conexión:
<?php
// config/defines_custom.inc.php
// Activa el modo depuración solo para esta IP. Borra el archivo al terminar.
if (isset($_SERVER['REMOTE_ADDR']) && $_SERVER['REMOTE_ADDR'] === '203.0.113.25') {
define('_PS_MODE_DEV_', true);
}
Cambia 203.0.113.25 por tu IP pública (búscala en Google como “cuál es mi IP”). Los demás visitantes siguen viendo la tienda como siempre, y tú ves el error completo en pantalla. Dos avisos:
- Si la tienda está detrás de Cloudflare o de otro proxy,
REMOTE_ADDRes la IP del proxy, no la tuya, y la condición no se cumple. En ese caso usa el registro, o pide a quien mantiene el servidor que lo haga. - Borra el archivo en cuanto tengas el mensaje. No lo dejes “por si acaso”.

Si el back office funciona, también puedes activar la depuración en Parámetros avanzados > Rendimiento > Modo depuración. Ese interruptor reescribe la línea de defines.inc.php (DebugMode, PrestaShop 8.2): la activa para todo el mundo.
Por qué pasa: el mensaje y su causa

| El mensaje dice | Qué significa | Qué hacer |
|---|---|---|
Allowed memory size of ... bytes exhausted |
PHP se ha quedado sin memoria | Subir memory_limit. PrestaShop recomienda 512M en producción (optimizaciones, PrestaShop) |
Maximum execution time of ... seconds exceeded |
El script ha tardado más de lo permitido | Si es una importación, subir max_execution_time (PrestaShop indica 300). Si es una página normal, algo va mal: mira qué módulo aparece en la ruta |
syntax error, unexpected ... o Call to undefined function ... justo después de un cambio en el hosting |
La versión de PHP no es compatible con tu PrestaShop o con un módulo | Volver a la versión de PHP anterior desde el panel del hosting y revisar la compatibilidad antes de subir |
Class "..." not found o Attempted to load class |
La caché de clases está desactualizada, normalmente tras instalar o actualizar un módulo | Vaciar la caché (ver abajo) |
SQLSTATE[HY000] [1045] Access denied |
Usuario o contraseña de la base de datos incorrectos | Revisar app/config/parameters.php. Si no los has cambiado tú, avisa al hosting |
SQLSTATE[HY000] [2002] |
El servidor de base de datos no responde | Es del hosting |
failed to open stream: Permission denied en var/cache |
Permisos de las carpetas | Carpetas a 755 y archivos a 644, con el propietario correcto |
Ruta en /modules/nombre/ |
Ese módulo | Desactivarlo (ver abajo) |
Ruta en /override/ |
Un override, casi siempre de un módulo antiguo | Desactivar los overrides (ver abajo) |
| Nada en el registro de PHP, error en el del servidor web | .htaccess |
Revisar lo último que se añadió fuera del bloque de PrestaShop |
Para el cambio de versión de PHP, qué versión admite cada PrestaShop lo tienes en la tabla de compatibilidad de PHP.
Cómo se arregla
Antes de tocar nada, copia de seguridad de archivos y de base de datos. Aunque la tienda esté caída. Si el arreglo sale mal, necesitas poder volver al punto de partida, no a la copia de hace una semana.
Vaciar la caché sin back office
Borra el contenido de var/cache/prod y de var/cache/dev (las carpetas pueden quedarse, vacías). PrestaShop las regenera en la siguiente visita, que tardará unos segundos más de lo normal. Es lo primero que hay que probar con un Class not found y lo último que hay que hacer después de cualquier otro arreglo.
Desactivar un módulo que no deja entrar
Si el back office funciona: Módulos > Gestor de módulos, buscar el módulo y Desactivar. No Desinstalar.
Si el back office no carga, cambia el nombre de su carpeta por FTP, de /modules/nombre/ a /modules/nombre-off/, y vacía la caché. Es reversible: para volver, le devuelves el nombre.
Desactivar los overrides
Parámetros avanzados > Rendimiento, en el bloque de depuración, la opción de desactivar todos los overrides. Al guardar, PrestaShop borra el índice de clases (DebugModeConfiguration, PrestaShop 8.2). Si el error desaparece, el problema está en uno de los archivos de /override/.
Cuando todo está bien
Borra defines_custom.inc.php, comprueba que _PS_MODE_DEV_ está en false en defines.inc.php y abre la tienda en una ventana privada: portada, una categoría, una ficha y un carrito hasta el paso del pago.
Lo que pasa mientras dura el error, y cuando se arregla

Un 500 no es solo una venta perdida. Google reduce el rastreo cuando un sitio devuelve errores de servidor, en proporción a cuántas URLs fallan, y las URLs que siguen dando error de forma persistente acaban saliendo del índice (errores HTTP y de red, Google). Google no da un plazo. Cuando el servidor vuelve a responder bien, recupera el ritmo de rastreo de forma gradual. Por eso un 500 de una hora apenas deja rastro, y uno de tres días puede costarte posiciones durante semanas.
Lo que se rompe si lo haces mal
- Dejar el modo depuración activado para todos. Expones rutas y consultas, y cualquier aviso menor se convierte en una página rota para el cliente.
- Desinstalar en lugar de desactivar. Desinstalar un módulo puede borrar sus tablas y su configuración. Si era el de pago o el de transporte, lo vas a echar de menos.
- Restaurar una copia antigua sin pensar. Pierdes los pedidos, los clientes y los cambios hechos desde la copia. Restaurar es la última opción, no la primera.
- Actualizar PrestaShop “a ver si se arregla”. Si el fallo es un módulo incompatible, la actualización lo empeora.
- Cambiar la versión de PHP otra vez sin mirar. Si el hosting la subió y eso rompió la tienda, bajarla arregla el síntoma, pero tu tienda sigue necesitando una versión de PHP con soporte.
- Borrar las carpetas de
var/cacheen lugar de su contenido. Si PrestaShop no puede volver a crearlas por permisos, sigues con el 500. Vacía su contenido y no toques los permisos.
Cuándo esto no lo puedes hacer tú
Puedes resolverlo tú si el registro señala un módulo concreto, una caché o la memoria, y tienes acceso al back office o al FTP. Necesitas ayuda si no encuentras ningún registro, si el error está en el núcleo y no ha cambiado nada, si es la base de datos, si la tienda es multitienda o si el fallo aparece y desaparece sin patrón. Eso es lo que resolvemos en el mantenimiento de PrestaShop, también cuando el problema de fondo es el servidor.