Solucionar error 500 PrestaShop en cPanel | Causas y pasos

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

El error 500, también conocido como error interno del servidor, es uno de los mensajes más comunes y frustrantes que puedes encontrar al gestionar una tienda PrestaShop. Aparece de repente, sin previo aviso, y no da detalles claros sobre qué lo causa. Básicamente, el servidor te dice: "Algo salió mal, pero no te voy a decir exactamente qué".

En el contexto de error 500 PrestaShop cPanel, este problema suele estar relacionado con archivos de configuración dañados, permisos incorrectos, módulos conflictivos o falta de memoria en el servidor. La buena noticia es que la mayoría de las veces se puede solucionar siguiendo pasos sencillos, sin necesidad de ser un experto en programación.

[INFO] El error 500 es un código de estado HTTP genérico. No significa que tu tienda esté rota para siempre, solo que el servidor no pudo procesar la solicitud por un problema interno.

Causas más frecuentes del error 500 en PrestaShop

Antes de lanzarte a hacer cambios, es útil entender por qué ocurre. Las causas más habituales son:

Archivo .htaccess corrupto o mal configurado: Este archivo controla las reglas de reescritura de URL y otras configuraciones del servidor. Si se daña, PrestaShop no puede cargar las páginas.
Módulo incompatible o mal instalado: A veces, al instalar un módulo nuevo o actualizar uno existente, se generan conflictos que rompen la tienda.
Permisos de archivos incorrectos: Los archivos y carpetas de PrestaShop necesitan permisos específicos para que el servidor pueda leerlos y ejecutarlos.
PHP memory limit agotado: Si tu tienda tiene muchos productos, tráfico o módulos pesados, puede que el límite de memoria PHP sea insuficiente.
Errores en el archivo config/settings.inc.php: Este archivo guarda la conexión a la base de datos. Si está dañado o tiene datos incorrectos, el sistema falla.
Problemas con el tema (plantilla): Un tema mal programado o desactualizado también puede provocar el error 500.

Paso 1: Activar el modo debug de PrestaShop para obtener más información

Lo primero que necesitas es que PrestaShop te dé pistas sobre el error. Por defecto, el sistema oculta los detalles por seguridad, pero puedes activar el modo debug para ver el mensaje real.

¿Cómo activar el modo debug?

Accede a tu cPanel (o al panel de control de tu hosting, como Syspanel si usas HestiaCP, que se accede por el puerto 2106).
Ve a la sección Administrador de archivos (File Manager).
Navega hasta la carpeta raíz de tu tienda PrestaShop (normalmente public_html o una subcarpeta como /tienda).
Busca el archivo config/defines.inc.php.
Haz clic derecho sobre él y selecciona Editar.
Localiza la línea que dice: define('_PS_MODE_DEV_', false);
Cámbiala por: define('_PS_MODE_DEV_', true);
Guarda los cambios.

Ahora, al recargar tu tienda, verás un mensaje de error más detallado (por ejemplo, "Fatal error: Allowed memory size exhausted" o "Class not found"). Eso te indicará exactamente qué está fallando.

[WARNING] No dejes el modo debug activado en una tienda en producción, ya que muestra información sensible. Una vez solucionado el error, vuelve a poner false.

Paso 2: Solucionar el error 500 PrestaShop cPanel restaurando el archivo .htaccess

El archivo .htaccess es uno de los principales sospechosos. Si está dañado, puedes regenerarlo fácilmente.

Pasos para regenerar el .htaccess:

Ve al Administrador de archivos de cPanel.
Busca el archivo .htaccess en la raíz de tu tienda. Si no lo ves, activa la opción Mostrar archivos ocultos (suele ser un checkbox en la parte superior).
Descarga una copia de seguridad de este archivo a tu ordenador (por si acaso).
Elimina el archivo .htaccess original (no te preocupes, PrestaShop lo recreará).
Accede al panel de administración de PrestaShop (ejemplo: tutienda.com/admin1234).
Ve a Parámetros de la tienda > Tráfico y SEO.
Haz clic en Guardar sin cambiar nada. Esto hará que PrestaShop genere un nuevo .htaccess limpio.

Si no puedes acceder al panel de administración, también puedes crear un .htaccess básico manualmente. Crea un archivo de texto con el siguiente contenido y súbelo a la raíz:

# START: PrestaShop
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
# END: PrestaShop

Luego, desde el panel de admin, vuelve a guardar la configuración de SEO para que se complete.

Paso 3: Verificar y corregir permisos de archivos y carpetas

Los permisos incorrectos son otra causa común del error 500 PrestaShop cPanel. Los valores recomendados son:

Carpetas: 755
Archivos: 644
Archivos de configuración (como config/settings.inc.php): 644

Cómo cambiar permisos desde cPanel:

En el Administrador de archivos, selecciona la carpeta raíz de tu tienda.
Marca la opción Seleccionar todo (o selecciona manualmente los archivos y carpetas).
Haz clic en Permisos en la barra de herramientas.
Establece 755 para carpetas y 644 para archivos.
Aplica los cambios.

[TIP] Si tienes muchos archivos, puedes hacerlo desde la terminal (SSH) con el comando find . -type d -exec chmod 755 {} \; y find . -type f -exec chmod 644 {} \;. Pero esto es más avanzado.

Paso 4: Aumentar el límite de memoria PHP

Si el error 500 aparece cuando intentas cargar páginas con muchos productos o al abrir el panel de administración, es probable que el límite de memoria PHP sea insuficiente.

Cómo aumentarlo en cPanel:

Ve a Seleccionar versión de PHP (o MultiPHP Manager).
Busca la opción memory_limit y cámbiala a un valor más alto, como 256M o 512M.
Guarda los cambios.

Si no ves esta opción, puedes crear o editar un archivo php.ini en la raíz de tu tienda con el siguiente contenido:

memory_limit = 256M
max_execution_time = 120
max_input_time = 120

Otra alternativa es modificar el archivo .htaccess y agregar esta línea:

php_value memory_limit 256M

Paso 5: Deshabilitar módulos conflictivos

Un módulo defectuoso o incompatible puede provocar el error 500. Si no puedes acceder al panel de administración, tendrás que deshabilitarlos manualmente.

Cómo deshabilitar módulos desde el administrador de archivos:

Ve a la carpeta /modules dentro de tu tienda.
Busca la carpeta del módulo sospechoso (por ejemplo, si el error comenzó tras instalar "mimodulo", busca esa carpeta).
Renombra la carpeta añadiendo un guion bajo al inicio, por ejemplo: _mimodulo. Esto desactivará el módulo sin eliminarlo.
Prueba si la tienda funciona. Si sí, ese módulo es el culpable.

Si no sabes qué módulo causó el problema, puedes renombrar la carpeta /modules completa (por ejemplo, a /modules_backup) y crear una nueva carpeta vacía llamada /modules. Luego, ve agregando módulos de uno en uno hasta encontrar el conflictivo.

[WARNING] Al renombrar la carpeta /modules perderás temporalmente la funcionalidad de todos los módulos, pero la tienda base debería funcionar.

Paso 6: Revisar el archivo config/settings.inc.php

Este archivo contiene la configuración de la base de datos. Si está dañado, PrestaShop no puede conectarse y muestra error 500.

Cómo verificar:

Abre el archivo config/settings.inc.php en el Administrador de archivos.
Verifica que los datos de la base de datos sean correctos (nombre, usuario, contraseña, servidor).
Si tienes acceso a phpMyAdmin desde cPanel, comprueba que la base de datos exista y que el usuario tenga permisos.

Si el archivo está corrupto, puedes restaurarlo desde una copia de seguridad o regenerarlo manualmente. Pero ten cuidado: si cambias los datos incorrectamente, perderás la conexión.

Paso 7: Verificar los logs del servidor

Los logs del servidor son tu mejor aliado para entender el error 500 PrestaShop cPanel. Te darán el mensaje exacto.

Cómo acceder a los logs en cPanel:

Ve a Registros de errores (Error Log) en cPanel.
Busca la entrada más reciente relacionada con tu tienda. Por ejemplo: PHP Fatal error: Allowed memory size of 67108864 bytes exhausted.
Anota el mensaje y la línea del archivo que causó el error.

Si usas Syspanel (HestiaCP), los logs suelen estar en /var/log/apache2/error.log o en la sección de logs del panel.

Paso 8: Restaurar una copia de seguridad

Si después de todos los pasos anteriores el error persiste, la solución más rápida es restaurar una copia de seguridad reciente de tu tienda. Esto revertirá cualquier cambio que haya causado el problema.

Cómo restaurar desde cPanel:

Ve a Copias de seguridad (Backup) en cPanel.
Descarga una copia completa de tu sitio (archivos y base de datos).
Si ya tienes una copia, súbela y restaura usando Restaurar una copia de seguridad.

[INFO] Siempre mantén copias de seguridad periódicas. En cPanel puedes programarlas automáticamente desde la sección Copias de seguridad > Copias de seguridad automáticas.

Preguntas frecuentes (FAQ) sobre el error 500 en PrestaShop

¿Por qué veo un error 500 después de instalar un módulo?

Es muy común. El módulo puede ser incompatible con tu versión de PrestaShop o consumir demasiados recursos. Sigue el Paso 5 para deshabilitarlo manualmente.

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

Sí, si tu tienda ha sido comprometida, los archivos pueden estar corruptos. Revisa los logs y busca archivos sospechosos (como shell.php). También ejecuta un escaneo de seguridad desde cPanel.

¿Puedo solucionar el error 500 sin acceso al panel de administración?

Sí, usando el Administrador de archivos de cPanel o Syspanel (puerto 2106). Todos los pasos de esta guía se pueden realizar desde ahí.

¿Qué hago si el error 500 aparece solo en algunas páginas?

Puede ser un problema con un módulo específico o con el tema. Activa el modo debug para ver el mensaje exacto y deshabilita módulos de a uno.

¿Debo contactar a mi proveedor de hosting?

Si después de seguir todos los pasos el error persiste, el problema puede ser del servidor (por ejemplo, falta de memoria RAM o configuración de PHP). Contacta a soporte y muéstrales los logs.

Conclusión final

El error 500 PrestaShop cPanel puede ser desconcertante, pero con paciencia y siguiendo esta guía paso a paso, podrás solucionar error 500 PrestaShop en la mayoría de los casos. Recuerda siempre:

Activar el modo debug para obtener pistas.
Regenerar el .htaccess.
Verificar permisos y memoria PHP.
Deshabilitar módulos problemáticos.
Revisar los logs del servidor.

Y lo más importante: haz copias de seguridad periódicas. Así, si algo sale mal, puedes restaurar tu tienda en minutos.

[TIP] Si usas Syspanel (HestiaCP), recuerda que el acceso es por el puerto 2106 y que muchas funciones son similares a cPanel. No dudes en consultar la documentación de tu hosting si tienes dudas específicas.

Esperamos que esta guía te haya sido útil. ¡Buena suerte con tu tienda PrestaShop!