Solucionar error 500 en PrestaShop | Guía SysAdmin

¡Vaya! Navegas tranquilamente por tu tienda PrestaShop y, de repente, te encuentras con una pantalla en blanco o un mensaje que dice "Error 500: Internal Server Error". Es una de las situaciones más frustrantes para cualquier dueño de tienda online. Pero no te preocupes, estás en el lugar correcto.

Este error, también conocido como Internal Server Error PrestaShop, es un mensaje genérico que indica que algo salió mal en el servidor, pero no especifica qué. Es como si tu coche dijera "fallo del motor" sin darte más detalles. Sin embargo, a diferencia de lo que puedas pensar, la mayoría de las causas son relativamente fáciles de diagnosticar y solucionar error 500 sin necesidad de ser un experto en programación.

En este artículo, vamos a desglosar las causas más comunes del error 500 PrestaShop y, lo más importante, te daré soluciones rápidas y prácticas que puedes aplicar paso a paso. Vamos a convertir ese "pantallazo blanco" en una lección aprendida.

¿Qué es exactamente el Error 500 en PrestaShop?

El error 500, o Internal Server Error PrestaShop, es un código de estado HTTP que significa que el servidor encontró una condición inesperada que le impidió completar la petición. En términos simples: el servidor web (Apache, Nginx, LiteSpeed) no pudo ejecutar el script de PrestaShop correctamente.

A diferencia de un error 404 (página no encontrada) o un error 403 (acceso denegado), el 500 es un "cajón de sastre". Las causas pueden ir desde un simple archivo .htaccess corrupto hasta un conflicto grave entre módulos. Pero no te asustes: con paciencia y siguiendo un orden lógico, podrás resolverlo.

Causas principales del Error 500 en PrestaShop

Antes de lanzarnos a soluciones, es clave entender qué puede estar provocando el problema. Estas son las causas más frecuentes:

1. Límite de memoria PHP excedido (memory_limit)

PrestaShop es un sistema robusto que consume recursos. Si tu tienda tiene muchos productos, módulos pesados o tráfico elevado, es fácil que el límite de memoria PHP se agote. Esto provoca un error 500 especialmente en páginas de administración o en procesos como la generación de PDFs.

2. Archivo .htaccess corrupto o mal configurado

Este archivo es el "libro de instrucciones" del servidor web. Si un módulo o una actualización lo modifica incorrectamente, puede generar un error 500. Es uno de los primeros lugares donde mirar.

3. Módulos con conflictos

Instalaste un módulo nuevo y ¡pum! error 500. O quizás actualizaste un módulo existente y dejó de ser compatible con tu versión de PrestaShop. Los módulos son la causa número uno de errores 500 en entornos de producción.

4. Problemas con el archivo settings.inc.php

Este archivo (ubicado en /config/settings.inc.php) contiene las credenciales de la base de datos. Si se corrompe, se borra o tiene permisos incorrectos, PrestaShop no podrá conectar con la base de datos y lanzará un error 500.

5. PHP timeout o ejecución demasiado larga

Si un script tarda más tiempo del permitido por el servidor (por ejemplo, al exportar un catálogo grande), el servidor lo mata y muestra el error 500.

6. Permisos de archivos incorrectos

Cada archivo y carpeta en tu servidor tiene unos permisos (lectura, escritura, ejecución). Si están mal configurados (por ejemplo, 777 en archivos sensibles o 644 en carpetas), PrestaShop puede fallar.

7. Versión de PHP incompatible

PrestaShop 1.6 necesita PHP 5.6 o 7.0, mientras que PrestaShop 1.7 y 8.x requieren PHP 7.1 o superior (idealmente 7.4 o 8.0). Si tu hosting cambió la versión de PHP sin avisar, puedes tener un error 500.

8. Problemas de caché

PrestaShop almacena en caché archivos de configuración, Smarty (plantillas) y clases. Si esta caché se corrompe (por ejemplo, tras una actualización), puede dar errores.

9. Base de datos corrupta o con tablas dañadas

Aunque es menos común, una tabla de la base de datos puede corromperse y provocar un error 500 al intentar acceder a ciertas páginas.

10. Hosting con recursos insuficientes

Si tu plan de hosting comparte recursos con otros sitios y uno de ellos consume mucho, tu tienda puede recibir un error 500 por falta de memoria o CPU.

Soluciones rápidas para el Error 500 en PrestaShop

Ahora sí, vamos al grano. Te presento una guía paso a paso para solucionar error 500 en PrestaShop. Empieza por la solución más sencilla y ve avanzando si el problema persiste.

🔍 Paso 1: Activar el modo debug de PrestaShop (para ver el error real)

Por defecto, PrestaShop oculta los detalles del error para proteger la seguridad. Activando el modo debug, verás el mensaje de error real (por ejemplo, "Fatal error: Allowed memory size exhausted").

¿Cómo hacerlo?

Accede a tu hosting mediante FTP (FileZilla, Cyberduck) o al administrador de archivos de tu panel de control.

Busca el archivo /config/defines.inc.php.
Ábrelo con un editor de texto (Notepad++, Sublime Text).
Busca la línea: define('_PS_MODE_DEV_', false);
Cámbiala a: define('_PS_MODE_DEV_', true);
Guarda el archivo y súbelo si lo modificaste localmente.

Ahora, al recargar la página que daba error 500, verás un mensaje detallado. Anótalo, porque te dará la pista definitiva. Cuando termines, no olvides volver a poner false para no exponer información sensible.

[INFO] Si no puedes acceder por FTP, muchos paneles de hosting (como cPanel o Syspanel) tienen un editor de archivos online. Recuerda que Syspanel se accede por el puerto 2106.

🔍 Paso 2: Renombrar el archivo .htaccess

El archivo .htaccess suele estar en la raíz de tu instalación de PrestaShop. Renombrarlo obliga a PrestaShop a generar uno nuevo.

Conéctate por FTP o al administrador de archivos.
Busca el archivo .htaccess (puede estar oculto; activa "Mostrar archivos ocultos" en tu cliente FTP).
Cámbiale el nombre a algo como .htaccess_backup.
Ahora, accede a cualquier página de tu tienda (por ejemplo, /es/). PrestaShop generará automáticamente un nuevo .htaccess con la configuración por defecto.

Si el error desaparece, el problema estaba en el archivo anterior. Si no, puedes restaurarlo.

[WARNING] Si tu tienda usa redirecciones personalizadas o reglas SEO avanzadas, al regenerar el .htaccess perderás esas reglas. Guárdalas antes.

🔍 Paso 3: Aumentar el límite de memoria PHP

Esta es la solución más común para el error 500 PrestaShop en tiendas con muchos módulos.

Opción A: Desde el archivo php.ini (si tienes acceso)

Busca o crea un archivo php.ini en la raíz de tu PrestaShop.
Añade o modifica esta línea: memory_limit = 256M (o incluso 512M si tu hosting lo permite).
Guarda y sube.

Opción B: Desde el archivo .htaccess

Añade estas líneas al final de tu .htaccess:

<IfModule mod_php7.c>
php_value memory_limit 256M
php_value max_execution_time 120
</IfModule>

Opción C: Desde el panel de hosting

En cPanel, busca "Select PHP Version" y luego "Switch to PHP Options". En Syspanel (puerto 2106), busca la sección de configuración de PHP. Ahí podrás cambiar el valor de memory_limit.

[TIP] Si tu hosting no te permite modificar estos valores, contacta con el soporte. Muchos planes básicos tienen límites muy bajos.

🔍 Paso 4: Deshabilitar todos los módulos (modo seguro)

Si el error apareció tras instalar o actualizar un módulo, esta es la solución estrella. Deshabilitaremos todos los módulos no esenciales.

Conéctate a tu base de datos mediante phpMyAdmin (desde cPanel o Syspanel).
Busca la tabla ps_module (prefijo ps_ puede variar).
Ejecuta esta consulta SQL: UPDATE ps_module SET active = 0 WHERE id_module > 1;
(Esto desactiva todos los módulos excepto los esenciales como el de configuración).
Vuelve a tu tienda. Si el error desaparece, el problema está en uno de los módulos desactivados.
Actívalos de uno en uno desde el back office (si puedes acceder) o mediante SQL: UPDATE ps_module SET active = 1 WHERE id_module = X; (sustituye X por el ID del módulo).

[INFO] Si no puedes acceder al back office, esta es la única vía. Hazlo con cuidado y ve probando.

🔍 Paso 5: Regenerar la caché de PrestaShop

A veces, la caché se corrompe y provoca el error 500.

Conéctate por FTP.
Elimina todo el contenido de las carpetas:
- /cache/smarty/compile/
- /cache/smarty/cache/
- /class_index.php (si existe)
No borres las carpetas, solo su contenido.
Vuelve a cargar la tienda.

🔍 Paso 6: Verificar permisos de archivos y carpetas

Los permisos incorrectos son una causa silenciosa de errores 500.

Carpetas deben tener permisos 755.
Archivos deben tener permisos 644.
El archivo settings.inc.php debe tener permisos 644 (o incluso 444 después de la instalación).

Puedes cambiarlos desde tu cliente FTP (clic derecho > Permisos) o desde el administrador de archivos.

🔍 Paso 7: Revisar la versión de PHP

Como mencioné antes, la compatibilidad de PHP es crítica.

PrestaShop 1.6: PHP 5.6 o 7.0 (7.0 es mejor).
PrestaShop 1.7.0 a 1.7.6: PHP 7.1 a 7.3.
PrestaShop 1.7.7 a 1.7.8: PHP 7.2 a 8.0.
PrestaShop 8.x: PHP 7.4 o 8.0/8.1.

Cambia la versión desde tu panel de hosting. En cPanel, busca "Select PHP Version". En Syspanel (puerto 2106), ve a "Configuración de PHP" y selecciona la versión recomendada.

🔍 Paso 8: Reparar la base de datos

Si sospechas de una tabla dañada:

Ve a phpMyAdmin.
Selecciona tu base de datos.
Marca todas las tablas (clic en "Seleccionar todo").
En el menú desplegable, elige "Reparar tabla".

Esto no siempre funciona, pero es rápido y no daña nada.

🔍 Paso 9: Revisar el log de errores del servidor

El servidor guarda registros de errores detallados. Accede a ellos:

cPanel: Sección "Metrics" > "Errors".
Syspanel: Busca "Logs" o "Registros de errores".
FTP: A veces hay un archivo error.log en la raíz.

Busca líneas que contengan "PHP Fatal error" o "PrestaShop". Te darán la pista exacta.

FAQ: Preguntas frecuentes sobre el Error 500 en PrestaShop

P: ¿El error 500 afecta al SEO de mi tienda?
R: Sí, porque Google no puede indexar páginas que devuelven errores. Si es temporal, no pasa nada, pero si dura días, puede penalizarte. Soluciona rápido.

P: ¿Puedo solucionar el error 500 sin acceso al back office?
R: Sí, la mayoría de soluciones (FTP, phpMyAdmin, panel de hosting) no necesitan el back office.

P: ¿Un error 500 puede deberse a un ataque?
R: Es posible. Si el error aparece de repente y ves archivos extraños, puede ser un hack. Revisa los logs y contacta con tu hosting.

P: ¿Debo contratar un hosting más caro para evitarlo?
R: No necesariamente. Muchos errores 500 son por configuraciones, no por falta de recursos. Pero si tu tienda crece, un hosting mejor siempre ayuda.

P: ¿Qué hago si después de todo esto sigue el error?
R: Contacta con el soporte técnico de tu hosting. Diles que has probado los pasos anteriores (menciónalos) y que necesitas ayuda con el Internal Server Error PrestaShop. Ellos pueden revisar los logs del servidor a nivel raíz.

Conclusión: No dejes que el Error 500 te paralice

El error 500 PrestaShop es como un resfriado: molesto, pero normalmente fácil de curar si sabes qué hacer. Hemos visto que las causas van desde un simple archivo corrupto hasta problemas de memoria, y que las soluciones son accesibles incluso para usuarios no técnicos.

Recuerda el orden lógico:

Activa el modo debug para ver el error real.
Renombra el .htaccess.
Aumenta la memoria PHP.
Desactiva módulos.
Limpia la caché.

Si aplicas estos pasos, en la mayoría de los casos tendrás tu tienda funcionando en minutos. Y si no, ya sabes que puedes recurrir a los logs del servidor o al soporte técnico.

Ahora, respira hondo, elige el paso que más se ajuste a tu situación y ponte manos a la obra. Tu tienda te lo agradecerá.

[TIP] Para evitar futuros errores 500, mantén PrestaShop y sus módulos siempre actualizados, haz copias de seguridad periódicas y elige un hosting que cumpla con los requisitos de PrestaShop. ¡Prevenir es mejor que curar!