Error 500 en PrestaShop: cómo encontrar la causa sin romper más la tienda

Error 500 en PrestaShop: cómo encontrar la causa

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/logs de 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_log en la carpeta donde ha fallado el script, y un apartado de errores en Métricas. En otros paneles está en Registros o Logs. 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.

Cómo leer una línea del registro de errores de PHP en PrestaShop: mensaje, archivo y línea
Cada línea del registro dice qué ha fallado, en qué archivo y en qué 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_ADDR es 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”.
Modo depuración de PrestaShop activado solo para una IP con defines_custom.inc.php
Con defines_custom.inc.php el error lo ves tú y los clientes siguen viendo la tienda.

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

Error 500 en PrestaShop: qué indica la ruta del archivo, módulos, overrides, tema o núcleo
La carpeta del archivo señala al culpable: módulo, override, tema o servidor.
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

Qué hace Google con un error 500 según cuánto dura: horas, días o persistente
Un 500 de horas apenas deja rastro. Uno persistente saca URLs del índice.

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/cache en 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.

Últimos Posts Publicados

Cómo Maximizar el Retorno de Inversión en Google Ads para Empresas B2B

Cómo Maximizar el Retorno de Inversión en Google Ads para Empresas B2B

Google Ads es una herramienta indispensable en toda estrategia de marketing online. Toda empresa que la utilice solo tiene un objetivo: Maximizar el ROI, para...

Seguir leyendo

¿Qué es el SEO negativo y como afecta al posicionamiento de tu web?

¿Qué es el SEO negativo y como afecta al posicionamiento de tu web?

Como bien sabes, una estrategia de posicionamiento SEO tiene objetivo ayudar en el posicionamiento de tu página web. Sin embargo, también puede ser utilizado en...

Seguir leyendo

Site Reputation Abuse: ¿Por qué es malo para tu sitio web?

Site Reputation Abuse: ¿Por qué es malo para tu sitio web?

Como propietarios de un sitio web, queremos conseguir visibilidad cuánto antes en los motores de búsqueda. Es lo que deseamos todos, pero a veces no...

Seguir leyendo

Mejores Prácticas en CRO: Cómo Convertir Visitantes en Clientes en tu Tienda PrestaShop

Mejores Prácticas en CRO: Cómo Convertir Visitantes en Clientes en tu Tienda PrestaShop

Optimizar la tasa de conversión (CRO) es clave para aumentar las ventas en tu tienda PrestaShop. En Mikksa Network, somos una agencia especialista en PrestaShop,...

Seguir leyendo

Integración de Módulos Esenciales en PrestaShop para Potenciar tu E-commerce

Integración de Módulos Esenciales en PrestaShop para Potenciar tu E-commerce

El mundo del comercio electrónico es super competitivo. Un campo de batalla en el que hay que destacar y ofrecer una experiencia de compra excepcional...

Seguir leyendo

Diseño Responsivo en PrestaShop: Asegurando la Mejor Experiencia en Todos los Dispositivos

Diseño Responsivo en PrestaShop: Asegurando la Mejor Experiencia en Todos los Dispositivos

¿Sabías que en España alrededor del 75% de las compras online ya se realizan a través de dispositivos móviles? Un dato que no solo nos...

Seguir leyendo