Solucionar Error 500 en PrestaShop: Guía para cPanel, DirectAdmin y Plesk

¿Qué es el error 500 en PrestaShop y por qué aparece?

El error 500, también conocido como "Internal Server Error", es uno de los mensajes más temidos por cualquier persona que gestiona una tienda online con PrestaShop. La buena noticia es que, en la mayoría de los casos, no es un problema grave y se puede solucionar con unos pocos pasos.

Este error significa que el servidor encontró una condición inesperada que le impidió completar la solicitud. En otras palabras, algo en tu tienda está fallando a nivel interno, pero el servidor no te da detalles específicos. Es como si tu coche no arrancara: sabes que hay un problema, pero necesitas abrir el capó para descubrir qué es.

Las causas más comunes incluyen: archivos con permisos incorrectos, un archivo .htaccess corrupto, problemas de memoria PHP, módulos incompatibles, o incluso un archivo settings.inc.php mal configurado. No te preocupes, vamos a ir paso a paso para identificar y resolver el problema, sin importar si usas cPanel, DirectAdmin o Plesk.

Preparación: Antes de empezar a solucionar

Antes de lanzarte a modificar archivos, es fundamental que prepares tu entorno de trabajo. Así evitarás errores adicionales y podrás revertir cambios si algo sale mal.

[WARNING] Nunca modifiques archivos directamente sin hacer una copia de seguridad previa. Un error de tipeo podría dejar tu tienda completamente inaccesible.

Paso 1: Accede al panel de control de tu hosting

Dependiendo de tu proveedor, tu panel será diferente. Aquí te explico cómo acceder en cada uno:

cPanel: Normalmente accedes a través de tudominio.com/cpanel o tudominio.com:2083. Usa las credenciales que te dio tu proveedor de hosting.
DirectAdmin: El acceso suele ser tudominio.com:2222 o tudominio.com:8443.
Plesk: El acceso es tudominio.com:8443 o a través del enlace que te proporcionó tu hosting.

Paso 2: Activa el modo debug de PrestaShop

El modo debug te mostrará el error real en pantalla, en lugar de la página genérica de error 500. Esto es clave para saber exactamente qué está fallando.

Para activarlo, necesitas editar el archivo config/defines.inc.php que está en la raíz de tu instalación de PrestaShop. Busca la siguiente línea:

define('_PS_MODE_DEV_', false);

Y cámbiala por:

define('_PS_MODE_DEV_', true);

[INFO] Si no encuentras esta línea, es posible que tu versión de PrestaShop use una estructura diferente. Busca en la carpeta config un archivo llamado defines.inc.php y dentro busca "MODE_DEV".

Guardar el archivo y recargar tu tienda ahora debería mostrarte un mensaje de error detallado con la ruta exacta del archivo problemático. Anota esa información, te será muy útil.

Solucionar error 500 en PrestaShop con cPanel

cPanel es uno de los paneles más populares en el mundo del hosting. Aquí tienes los pasos específicos para resolver el error 500 prestashop cpanel.

Solución 1: Corregir permisos de archivos y carpetas

Los permisos incorrectos son la causa más común del error 500. Cuando los archivos tienen permisos demasiado restrictivos o demasiado permisivos, el servidor no puede leerlos o ejecutarlos correctamente.

Accede al Administrador de Archivos de cPanel. Lo encontrarás en la sección "Archivos".
Navega hasta la raíz de tu PrestaShop (normalmente public_html o www).
Selecciona todos los archivos y carpetas. Puedes hacer clic en "Seleccionar todo" en la esquina superior derecha.
Haz clic en "Permisos" en la barra superior.
Configura los permisos de la siguiente manera:
- Carpetas: 755 (lectura, escritura y ejecución para el propietario; lectura y ejecución para el grupo y otros).
- Archivos: 644 (lectura y escritura para el propietario; lectura para el grupo y otros).

[TIP] Si tu hosting usa PHP como módulo (no como CGI), también puedes probar con permisos 775 para carpetas y 664 para archivos. A veces el servidor necesita que el grupo tenga permisos de escritura.

Solución 2: Regenerar el archivo .htaccess

Un archivo .htaccess corrupto o mal configurado puede causar errores 500. PrestaShop genera este archivo automáticamente, así que podemos forzar su regeneración.

Ve al Administrador de Archivos y localiza el archivo .htaccess en la raíz de tu tienda.
Renómbralo a algo como .htaccess.bak (esto crea una copia de seguridad).
Ve al panel de administración de PrestaShop (si puedes acceder). Si no puedes, necesitarás otro método.
En el panel, ve a Parámetros avanzados → Rendimiento.
Haz clic en "Regenerar el archivo .htaccess" y guarda.

Si no puedes acceder al panel de administración, puedes crear un archivo .htaccess vacío y subirlo a la raíz. PrestaShop lo regenerará automáticamente cuando intentes acceder a tu tienda.

Solución 3: Aumentar el límite de memoria PHP

PrestaShop puede necesitar más memoria de la que tu servidor tiene configurada por defecto. Esto es especialmente común si tienes muchos módulos o una tienda grande.

En cPanel, busca la sección "Software" y haz clic en "Select PHP Version" o "MultiPHP Manager".
Selecciona tu dominio en la lista.
Haz clic en "Switch to PHP Options" o el botón de configuración.
Busca la opción memory_limit y cámbiala a 256M o incluso 512M si tu hosting lo permite.
Guarda los cambios y prueba tu tienda de nuevo.

También puedes editar el archivo php.ini directamente si tienes acceso, pero la opción anterior es más segura y fácil.

Solucionar error 500 en PrestaShop con DirectAdmin

DirectAdmin tiene una estructura diferente a cPanel, pero los principios son los mismos. Aquí tienes las soluciones específicas para el error 500 prestashop directadmin.

Solución 1: Verificar permisos desde el administrador de archivos

DirectAdmin incluye un administrador de archivos muy completo. Para corregir permisos:

Accede al administrador de archivos de DirectAdmin. Lo encontrarás en el menú principal, bajo "Archivos".
Navega a la carpeta de tu dominio (normalmente domains/tudominio.com/public_html).
Selecciona todos los archivos (puedes usar Ctrl+A o el botón de selección).
Haz clic en "Cambiar permisos" en el menú superior.
Configura los permisos igual que en cPanel: carpetas 755, archivos 644.

[WARNING] En DirectAdmin, asegúrate de que el propietario de los archivos sea el usuario correcto del hosting. Si los archivos pertenecen a root en lugar de tu usuario, el servidor no podrá leerlos correctamente. Si es el caso, usa la opción "Cambiar propietario" para asignarlos a tu usuario.

Solución 2: Revisar el archivo de configuración de PHP

DirectAdmin te permite gestionar la configuración de PHP de forma más granular. Para aumentar la memoria:

Ve a "Configuración de PHP" en el menú de DirectAdmin. Esta opción puede llamarse "PHP" o "Config PHP".
Busca la configuración de tu dominio específico.
Localiza la directiva memory_limit y cámbiala a 256M.
Guarda los cambios y reinicia PHP si es necesario (puede que DirectAdmin te pida confirmación).

Solución 3: Desactivar el caché de PrestaShop vía FTP

A veces el error 500 está relacionado con una caché corrupta. Si no puedes acceder al panel de administración, puedes desactivarla manualmente:

Conecta por FTP a tu servidor usando un cliente como FileZilla.
Navega a la carpeta var/cache (en PrestaShop 1.7+) o cache (en PrestaShop 1.6).
Elimina todos los archivos dentro de la carpeta cache pero no la carpeta en sí.
Intenta acceder a tu tienda nuevamente.

[TIP] Si no tienes acceso FTP, puedes usar el administrador de archivos de DirectAdmin para hacer lo mismo. Busca la carpeta cache en la raíz de tu instalación.

Solucionar error 500 en PrestaShop con Plesk

Plesk tiene una interfaz moderna y algunas herramientas específicas que facilitan la solución de problemas. Aquí tienes las soluciones para el error 500 prestashop plesk.

Solución 1: Usar el administrador de archivos de Plesk

Accede al panel de Plesk y navega hasta tu dominio.
Haz clic en "Administrador de archivos" en el menú de la izquierda.
Ve a la carpeta httpdocs (equivalente a public_html).
Selecciona todos los archivos y haz clic en el icono de "Permisos" en la barra superior.
Configura los permisos a 755 para carpetas y 644 para archivos.

[INFO] En Plesk, es común que el propietario de los archivos sea www-data o similar. Asegúrate de que los archivos pertenecen al usuario del sistema que corresponde a tu suscripción. Si no, usa la opción "Cambiar propietario" para corregirlo.

Solución 2: Gestionar la configuración de PHP desde Plesk

Plesk ofrece un control muy fino sobre la configuración de PHP por dominio:

Ve a tu dominio en Plesk.
Haz clic en "PHP Settings" o "Configuración de PHP" en el menú.
Busca la opción memory_limit y cámbiala a 256M o 512M.
También revisa max_execution_time y ponlo a 300 segundos si es necesario.
Guarda los cambios y recarga tu tienda.

Solución 3: Revisar los logs de error en Plesk

Plesk tiene una herramienta de logs muy útil que puede darte pistas sobre el error:

En tu dominio, haz clic en "Logs" en el menú principal.
Busca el archivo de error log (normalmente error.log o php_error.log).
Abre el archivo más reciente y busca las últimas líneas que contengan "error" o "fatal".
Anota los errores específicos que encuentres. Esto te dará una pista clara sobre qué está fallando.

Soluciones generales para cualquier panel de control

Independientemente de si usas cPanel, DirectAdmin, Plesk o incluso Syspanel (antes conocido como HestiaCP, que puedes acceder por el puerto 2106), estas soluciones funcionan en todos los casos.

Solución 1: Desactivar módulos incompatibles

Un módulo recién instalado o actualizado puede estar causando el error 500. Para desactivarlo sin acceder al panel:

Accede a tu servidor por FTP o mediante el administrador de archivos de tu panel.
Navega a la carpeta modules en la raíz de PrestaShop.
Renombra la carpeta del módulo sospechoso añadiendo _disabled al final. Por ejemplo, mimodulo → mimodulo_disabled.
Prueba tu tienda. Si funciona, el problema era ese módulo.

[WARNING] Si no sabes qué módulo está causando el problema, renombra todos los módulos de uno en uno hasta encontrar el culpable. Es un proceso lento pero efectivo.

Solución 2: Limpiar la caché de Smarty

PrestaShop usa Smarty como motor de plantillas, y su caché puede corromperse fácilmente:

Conecta por FTP a tu servidor.
Navega a la carpeta var/smarty/cache (en PrestaShop 1.7+) o cache/smarty/cache (en PrestaShop 1.6).
Elimina todos los archivos dentro de estas carpetas, pero no las carpetas en sí.
También limpia la carpeta var/smarty/compile o cache/smarty/compile de la misma manera.

[TIP] Algunos hostings tienen activado el "opcache" de PHP, que puede almacenar versiones antiguas de tus archivos. Si las soluciones anteriores no funcionan, contacta con tu proveedor para que limpien el opcache.

Solución 3: Comprobar la versión de PHP

PrestaShop necesita una versión de PHP compatible. Las versiones antiguas de PrestaShop (1.6 y anteriores) no funcionan bien con PHP 7.4 o superior. Las versiones nuevas (1.7.7+) necesitan PHP 7.2 como mínimo.

Accede a la configuración de PHP de tu panel de control.
Verifica la versión actual de PHP.
Si tienes PrestaShop 1.6, prueba a cambiar a PHP 7.0 o 7.1.
Si tienes PrestaShop 1.7, asegúrate de tener PHP 7.2 o superior.

[INFO] En Syspanel (el panel antes conocido como HestiaCP, accesible por el puerto 2106), puedes cambiar la versión de PHP desde "Web Domain" → "PHP Version".

Preguntas frecuentes (FAQ)

¿Por qué mi tienda PrestaShop da error 500 después de una actualización?

Esto es muy común. Las actualizaciones pueden dejar archivos de caché antiguos, permisos incorrectos o incompatibilidades con módulos. Sigue los pasos de limpieza de caché y verificación de permisos que hemos visto. Si el problema persiste, revisa si tus módulos son compatibles con la nueva versión.

¿El error 500 puede ser culpa del hosting?

Sí, a veces el servidor tiene problemas de memoria o configuración restrictiva. Si has probado todas las soluciones y el error persiste, contacta con tu proveedor de hosting. Ellos pueden revisar los logs del servidor y ajustar la configuración de PHP.

¿Cómo puedo evitar el error 500 en el futuro?

La prevención es clave. Mantén PrestaShop y sus módulos siempre actualizados, haz copias de seguridad regulares, y evita instalar módulos de dudosa procedencia. También es recomendable hacer cambios en tu tienda fuera del horario de mayor tráfico.

¿Qué hago si no puedo acceder al panel de administración de PrestaShop?

No te preocupes, todas las soluciones que hemos visto se pueden hacer desde el panel de control de tu hosting o por FTP. Si no tienes acceso a ninguno de los dos, contacta con tu proveedor de hosting para que te ayuden.

¿Cuánto tiempo tarda en solucionarse un error 500?

En la mayoría de los casos, entre 10 y 30 minutos si sigues los pasos correctamente. Los problemas más complejos, como incompatibilidades de módulos, pueden llevar más tiempo.

Consejos finales y resumen

El error 500 en PrestaShop es un problema común pero solucionable. La clave está en identificar la causa raíz, y para eso el modo debug es tu mejor aliado. Recuerda siempre:

Activa el modo debug para ver el error real.
Corrige los permisos de archivos y carpetas.
Regenera el archivo .htaccess.
Aumenta el límite de memoria PHP.
Limpia la caché de PrestaShop y Smarty.
Desactiva módulos sospechosos.
Verifica la versión de PHP compatible con tu PrestaShop.

[TIP] Si después de todos estos pasos el error persiste, no dudes en