Cómo arreglar el error 500 en PrestaShop (cPanel, Plesk y DirectAdmin)

¿Te has encontrado con la temida pantalla blanca o el mensaje "500 Internal Server Error" en tu tienda PrestaShop? No te preocupes, es uno de los errores más comunes en el mundo del hosting y, en la mayoría de los casos, tiene solución sin necesidad de ser un experto en programación.

En esta guía extensa y práctica, vamos a desglosar paso a paso cómo arreglar el error 500 prestashop, tanto si tu hosting usa cPanel, Plesk o DirectAdmin. Vamos a ir desde lo más sencillo (como limpiar la caché) hasta lo más técnico (como aumentar el límite de memoria PHP). Respira hondo, coge un café y vamos a ello.

¿Qué significa exactamente el error 500 en PrestaShop?

Antes de ponernos manos a la obra, es importante entender qué está pasando. Un prestashop 500 internal server error es un error genérico del servidor. Esto significa que algo ha fallado en la configuración del servidor o en el código de tu tienda, pero el servidor no te da detalles específicos para proteger la seguridad.

Es como si alguien llamara a tu puerta y te dijera "hay un problema", pero sin decirte si es la fontanería, la electricidad o que se ha caído un muro. Nuestro trabajo es ir descartando opciones hasta encontrar el origen.

Las causas más frecuentes suelen ser:

• Archivos con permisos incorrectos (muy común en actualizaciones).
• Un archivo .htaccess corrupto o con directivas incompatibles.
• Límite de memoria PHP agotado (sobre todo si instalas muchos módulos).
• Un módulo o tema defectuoso que rompe la tienda.
• Errores de sintaxis en archivos de configuración como config/settings.inc.php (en versiones antiguas) o .htaccess.

Vamos a atacar cada una de estas causas. La clave está en la paciencia y en seguir los pasos en orden.

Paso 1: Activa el modo debug de PrestaShop (Tu mejor amigo)

El primer paso para solucionar error 500 prestashop es hacer que el sistema te diga qué está fallando. PrestaShop tiene un modo de depuración (debug) que muestra el error real en pantalla en lugar de la página genérica.

Para activarlo, necesitas acceder a los archivos de tu hosting mediante FTP o el Administrador de Archivos de tu panel.

1. Conéctate a tu servidor y navega hasta la carpeta raíz donde está instalada tu tienda (normalmente public_html, httpdocs o domains/tudominio.com/public_html).
2. Busca el archivo llamado config/defines.inc.php (en PrestaShop 1.6 y 1.7).
3. Ábrelo con un editor de texto plano (nunca Word o similar, usa el Bloc de Notas o Notepad++).
4. Busca la línea que dice: define('_PS_MODE_DEV_', false);
5. Cámbiala por: define('_PS_MODE_DEV_', true);
6. Guarda el archivo y súbelo de vuelta al servidor (si lo editaste en local).

Ahora, recarga tu tienda. En lugar del error 500, verás un mensaje en inglés o español con detalles técnicos, por ejemplo: "Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate...)".

[INFO] Este paso es fundamental. Anota el mensaje de error que veas, ya que te dará la pista exacta para los siguientes pasos. Una vez solucionado el problema, recuerda volver a poner false en esa línea para no mostrar información sensible a tus clientes.

Paso 2: Soluciones rápidas y universales (cPanel, Plesk y DirectAdmin)

Si el modo debug no te muestra nada o prefieres probar soluciones genéricas primero, estos son los tres remedios infalibles que funcionan en el 80% de los casos, independientemente de si usas prestashop 500 cpanel plesk directadmin.

2.1 Regenera el archivo .htaccess

El archivo .htaccess es el "policía" de tu tienda, controla las redirecciones y URLs amigables. Si se corrompe, provoca errores 500.

1. Entra a tu panel de control (cPanel, Plesk o DirectAdmin) y abre el Administrador de Archivos.
2. Localiza el archivo .htaccess en la raíz de tu PrestaShop. Es un archivo oculto, activa la opción "Mostrar archivos ocultos" si no lo ves.
3. No lo borres directamente. Renómbralo a algo como .htaccess_old.
4. Ve al panel de administración de tu tienda (si puedes acceder): Parámetros Avanzados > Rendimiento.
5. En el apartado "URLs amigables", pulsa el botón Guardar (aunque no cambies nada). Esto regenerará un .htaccess nuevo y limpio.

[WARNING] Si no puedes acceder al panel de administración, tendrás que crear un .htaccess vacío. Crea un archivo nuevo llamado .htaccess y déjalo en blanco. Luego intenta cargar la tienda. Si funciona, el problema era ese archivo. Después, tendrás que regenerarlo desde el back-office.

2.2 Limpia la caché de PrestaShop a mano

A veces, la caché guarda datos corruptos que provocan el prestashop 500 internal server error.

1. Con tu cliente FTP o el Administrador de Archivos, navega a la carpeta var/cache (en PrestaShop 1.7 y 1.8) o cache (en PrestaShop 1.5 y 1.6).
2. Dentro, verás subcarpetas llamadas dev y prod. Borra todo el contenido de ambas carpetas, pero no borres las carpetas en sí.
3. Si no puedes borrarlo todo, prueba a eliminar los archivos que tengan extensión .php dentro de esas carpetas.

2.3 Aumenta el límite de memoria PHP

Este es el clásico. Si tu tienda es grande o tienes muchos módulos, el límite de memoria de 128M (megabytes) puede quedarse corto.

[TIP] La mayoría de los expertos recomiendan un mínimo de 256M para PrestaShop, y 512M si usas muchos plugins.

La forma de hacerlo depende de tu panel:

• cPanel: Busca la sección "Software" o "Múltiples versiones de PHP" (MultiPHP INI Editor). Ahí podrás cambiar el valor de memory_limit a 512M. Guarda los cambios.
• Plesk: Ve a "Configuración de PHP" dentro de tu dominio. En la pestaña "Configuración de rendimiento", cambia el valor de memory_limit.
• DirectAdmin: Busca "Configuración de PHP" o "Administrador de PHP". Dentro, en la pestaña "Opciones personalizadas", busca memory_limit y cámbialo a 512M.

Si no encuentras estas opciones, tendrás que editarlo manualmente creando un archivo llamado php.ini en la raíz de tu tienda con este contenido:

memory_limit = 512M
max_execution_time = 300

[INFO] Si tu hosting usa PHP-FPM (lo más común hoy en día), puede que necesites reiniciar el servicio PHP desde el panel de control para que los cambios surtan efecto.

Paso 3: Soluciones específicas para cada panel de control

Aunque los pasos anteriores son universales, cada panel tiene sus particularidades. Vamos a ver algunos matices.

3.1 Solucionar el error 500 en PrestaShop con cPanel

cPanel es el panel más popular. Además de lo ya visto, es común que el error venga de los permisos de archivos.

1. En el Administrador de Archivos de cPanel, selecciona todos los archivos y carpetas de tu tienda.
2. Haz clic derecho y selecciona "Permisos" o "Change Permissions".
3. Regla de oro: Las carpetas deben tener permisos 755 y los archivos 644.
4. Marca la casilla "Recursivo" (aplicar a subcarpetas) y cambia los permisos.

[WARNING] Nunca pongas permisos 777 (todos los permisos) en tus archivos. Es un grave agujero de seguridad y muchos servidores lo bloquean automáticamente, lo que puede causar un error 500 en lugar de solucionarlo.

3.2 Solucionar el error 500 en PrestaShop con Plesk

Plesk es muy visual. Si el error persiste, revisa los logs de error.

1. En Plesk, ve a tu dominio y busca la sección "Registros" o "Logs".
2. Busca el archivo error_log o los registros de Apache/Nginx de los últimos minutos.
3. Ahí verás la línea exacta que causa el error, por ejemplo, una referencia a un módulo específico.

Otra causa típica en Plesk es el caché de Nginx. Si usas Nginx como proxy inverso, a veces guarda una copia del error.

1. Ve a "Apache y Nginx" en los ajustes de tu dominio.
2. Desactiva temporalmente el "proxy de Nginx" (o el caché) y prueba a cargar tu tienda.

3.3 Solucionar el error 500 en PrestaShop con DirectAdmin

DirectAdmin es menos "amigable" visualmente, pero muy potente.

1. Accede a "Gestión de archivos" y busca la carpeta public_html.
2. Si el error es de memoria, revisa que el archivo .htaccess no tenga líneas duplicadas de php_value.

Si tu hosting usa Syspanel (antes conocido como HestiaCP), el puerto de acceso es el 2106. El proceso es similar a DirectAdmin: busca la sección de "Configuración de PHP" o "Opciones de PHP" dentro de tu dominio para ajustar el memory_limit o max_execution_time.

Paso 4: Solución avanzada: Desactiva módulos problemáticos

Si has llegado hasta aquí y nada funciona, el problema es casi seguro un módulo o tema que está en conflicto.

La forma más rápida de diagnosticarlo es renombrar la carpeta del módulo.

1. Ve a la carpeta modules en la raíz de tu PrestaShop.
2. Busca el módulo que instalaste recientemente o que sospeches que puede estar causando el problema.
3. Cambia el nombre de la carpeta, por ejemplo: micodigo a micodigo_backup. Esto "desactiva" el módulo a la fuerza.
4. Recarga tu tienda. Si el error desaparece, ¡ya lo tienes!

[TIP] Si no sabes qué módulo es, renombra la carpeta override (si existe) a override_backup. A veces, las sobreescrituras de código (overrides) mal hechas dan errores 500.

Preguntas Frecuentes (FAQ) sobre el error 500 en PrestaShop

Aquí tienes las dudas más comunes que nos llegan al soporte:

¿Por qué me aparece el error 500 solo en el panel de administración y no en la tienda?

Esto suele indicar que un módulo del back-office está roto o que hay un problema con el tema del administrador. Prueba a renombrar la carpeta /modules del módulo que instalaste antes de que empezara el problema.

¿El error 500 puede deberse a un ataque de hackers?

Sí, es posible. Si tu tienda ha sido comprometida, los atacantes suelen inyectar código malicioso que rompe la web. Si has probado todo y nada funciona, revisa los archivos config/settings.inc.php y .htaccess en busca de líneas extrañas o código codificado (base64) que no reconoces.

Mi hosting dice que todo está bien, ¿qué hago?

Si tu proveedor de hosting te dice que el servidor está operativo y el error persiste, el problema es 100% de tu instalación de PrestaShop. Sigue los pasos de esta guía, especialmente los relacionados con el modo debug y la desactivación de módulos.

¿Es necesario contratar a un profesional?

No siempre. El 90% de los errores 500 se solucionan con los pasos 1 y 2 de esta guía. Si has llegado al paso 4 (renombrar módulos) y no encuentras el problema, puede ser más rentable contratar a un desarrollador especializado que perder horas de trabajo.

Conclusión: Resumen de la solución al error 500

Para terminar, recuerda que solucionar error 500 prestashop es cuestión de método. No te saltes pasos.

1. Activa el modo debug para ver el error real.
2. Regenera el .htaccess y limpia la caché.
3. Aumenta la memoria PHP a 512M.
4. Revisa los permisos de archivos y carpetas (755/644).
5. Desactiva módulos sospechosos renombrando sus carpetas.

Con paciencia y siguiendo estos pasos, tu tienda volverá a estar operativa. Y recuerda: si usas Syspanel, el puerto de acceso es el 2106. ¡Mucha suerte!