Error 500 en PrestaShop cPanel | Causas y soluciones

¡Hola! Si estás leyendo esto, probablemente te has encontrado con la temida pantalla en blanco o el mensaje "Error 500 Internal Server Error" en tu tienda PrestaShop alojada en un servidor con cPanel. No te preocupes, es uno de los errores más comunes y, por suerte, suele tener solución. En esta guía completa y paso a paso, te voy a explicar cómo solucionar error 500 PrestaShop cPanel de forma clara y sin necesidad de ser un experto en programación.

Vamos a desglosar las causas más frecuentes y las soluciones prácticas. Recuerda que un error 500 es un error genérico del servidor, lo que significa que algo está fallando en la configuración de tu web, en los archivos de PrestaShop o en los recursos del servidor. Pero con paciencia y siguiendo estos pasos, lo resolveremos.

¿Qué es exactamente un error 500 en PrestaShop?

Un error 500, o "Internal Server Error", es la forma que tiene el servidor de decirte: "Algo salió mal, pero no sé decirte exactamente qué". En el contexto de PrestaShop cPanel error, las causas más comunes son:

Archivos con permisos incorrectos (muy frecuente).
Un archivo .htaccess dañado o mal configurado.
Un módulo o tema de PrestaShop que genera un conflicto.
Límites de memoria de PHP excedidos.
Corrupción en archivos del núcleo de PrestaShop.
Problemas con la base de datos.

Vamos a ir solucionando cada una de estas posibles causas, desde lo más sencillo a lo más complejo.

Paso 1: Lo primero, activa el modo debug de PrestaShop

El error 500 es muy vago. Para obtener más información, debemos "obligar" a PrestaShop a que nos muestre el error real. Esto se hace activando el modo debug (depuración).

¿Cómo activar el modo debug?

Accede a tu cPanel. Normalmente es tudominio.com/cpanel o tudominio.com:2083.
Busca la herramienta "Administrador de Archivos" (File Manager) y entra en la carpeta public_html (o la carpeta donde esté instalada tu tienda).
Busca el archivo config/defines.inc.php. Ábrelo con el editor de texto (clic derecho -> Editar o View/Edit).
Busca la línea que dice:
define('_PS_MODE_DEV_', false);
Cámbiala por:
define('_PS_MODE_DEV_', true);
También, justo debajo, puedes añadir (o descomentar si ya existe) esta línea para que los errores se muestren en pantalla:
define('_PS_DISPLAY_COMPATIBILITY_WARNING_', true);
Y para mostrar errores de PHP, añade al principio del archivo (después de <?php):
ini_set('display_errors', 'on');
Guarda los cambios.

[INFO] Al activar el modo debug, en lugar de la pantalla en blanco, verás un mensaje de error específico (por ejemplo, "Fatal error: Allowed memory size exhausted..." o "Class not found"). Ese mensaje es tu mejor pista. Anótalo o haz una captura de pantalla.

Si después de esto ves el error, genial. Si no ves nada, vuelve a cargar la página. Si el error persiste, continúa con los siguientes pasos.

Paso 2: Revisa y repara el archivo .htaccess

El archivo .htaccess es un archivo de configuración crítico para PrestaShop. Si está dañado, genera un error 500 inmediato.

¿Cómo regenerar el .htaccess?

Desde el Administrador de Archivos de cPanel, asegúrate de ver los archivos ocultos (hay un botón o checkbox en la parte superior que dice "Mostrar archivos ocultos").
Busca el archivo llamado .htaccess (con el punto al inicio). Si existe, renómbralo a algo como .htaccess_backup (por si acaso). Si no existe, no pasa nada.
Ahora, entra en el panel de administración de tu PrestaShop (intenta acceder a /admin1234 o la URL que hayas configurado). Si no puedes acceder, no te preocupes.
Ve a Configuración de la tienda -> Rendimiento (o "Performance" en inglés).
Busca la opción "Regenerar archivo .htaccess" y haz clic en el botón. Guarda la configuración.

[TIP] Si no puedes acceder al panel de administración, puedes crear un archivo .htaccess nuevo y vacío desde el Administrador de Archivos (clic derecho -> Nuevo archivo). Luego, desde el modo debug, intenta cargar la página. Si el error desaparece, el problema era el .htaccess antiguo. A veces, el simple hecho de eliminar o renombrar el .htaccess soluciona el error 500 PrestaShop cPanel.

Paso 3: Verifica los permisos de archivos y carpetas

Los permisos incorrectos son una causa muy común del error 500 PrestaShop cPanel. Deben ser específicos.

Permisos correctos en PrestaShop:

Carpetas (directorios): Deben tener permisos 755.
Archivos (como .php, .tpl, .js): Deben tener permisos 644.

¿Cómo cambiarlos desde cPanel?

En el Administrador de Archivos, selecciona todas las carpetas y archivos de la raíz de tu tienda (puedes usar Ctrl+A).
Haz clic derecho sobre la selección y elige "Cambiar permisos".
Verás una ventana. Para carpetas, marca los checkboxes así:
- Propietario: Lectura, Escritura, Ejecución (7)
- Grupo: Lectura, Ejecución (5)
- Público: Lectura, Ejecución (5) -> Esto es el 755.
Para archivos, desmarca la opción "Ejecución" en todas las casillas, dejando solo Lectura y Escritura para el propietario, y solo Lectura para Grupo y Público. Esto es 644.

[WARNING] No pongas permisos 777 (todos los permisos a todos). Es un grave riesgo de seguridad. Si lo has hecho, cámbialo inmediatamente a 755 para carpetas y 644 para archivos.

Paso 4: Aumenta el límite de memoria de PHP

Si el error que ves en el modo debug dice algo como "Allowed memory size of X bytes exhausted", el problema es que tu script necesita más memoria de la que el servidor le permite. Esto es muy común al instalar módulos o temas pesados.

¿Cómo aumentar la memoria desde cPanel?

En cPanel, busca la herramienta "Seleccionar versión de PHP" (o "MultiPHP Manager").
Se abrirá una ventana. Busca la opción "Opciones de PHP" (o "Switch to PHP Options").
Localiza la directiva memory_limit. El valor predeterminado suele ser 128M o 256M. Cámbialo a 512M o incluso 1024M (1GB) si tu hosting lo permite.
Guarda los cambios y recarga la página de tu tienda.

[INFO] Si no encuentras la opción de cambiar memory_limit, contacta con tu proveedor de hosting. Algunos planes tienen límites fijos.

Paso 5: Desactiva módulos y temas conflictivos (a través de FTP o cPanel)

A veces, un módulo o tema recién instalado o actualizado es el culpable. Si no puedes acceder al panel de administración, debemos desactivarlos manualmente.

Desactivar módulos desde el Administrador de Archivos:

Ve a la carpeta /modules en tu instalación de PrestaShop.
Busca la carpeta del módulo que sospechas que está causando el problema (por ejemplo, si instalaste un módulo de pago justo antes del error, busca su carpeta).
Renombra la carpeta del módulo añadiendo algo como _old o _disabled al final. Por ejemplo, micromodulo -> micromodulo_disabled.
Si no sabes cuál es, puedes ir desactivando módulos uno por uno (renombrando su carpeta) hasta que el error desaparezca. Empieza por los módulos de pago, envío y los que hayas instalado recientemente.

Desactivar el tema actual:

Ve a la carpeta /themes.
Verás una carpeta con el nombre de tu tema activo (por ejemplo, classic o el nombre de tu tema personalizado).
Renombra esa carpeta a algo como tema_actual_backup.
PrestaShop, al no encontrar el tema, intentará cargar el tema por defecto (classic). Si el error desaparece, el problema era tu tema.

Paso 6: Restaura archivos del núcleo de PrestaShop

Si los pasos anteriores no funcionan, es posible que algún archivo del núcleo de PrestaShop esté corrupto. La solución más segura es reemplazar los archivos del núcleo sin tocar tus datos (productos, clientes, etc.).

¿Cómo hacerlo?

Descarga la misma versión de PrestaShop que tienes instalada. Puedes ver tu versión en el panel de administración (en el pie de página) o en el archivo install/install_version.php (si existe).
Descomprime el archivo en tu ordenador.
Sube SOLO las siguientes carpetas a tu servidor (a través de FTP o el Administrador de Archivos de cPanel), reemplazando los archivos existentes:
- /admin (la carpeta de administración, pero cuidado: si la renombraste, no la reemplaces, o perderás el acceso).
- /classes
- /controllers
- /core
- /override (solo si no has hecho overrides personalizados; si los tienes, no subas esta carpeta).
- /src
- /vendor
- /config (pero NO subas los archivos settings.inc.php ni defines.inc.php, ya que contienen tu configuración de base de datos y debug).
No subas las carpetas /img, /themes, /modules, /download, /upload ni /mails, ya que contienen tus datos personalizados y podrías perderlos.

[WARNING] Este paso es delicado. Si no te sientes seguro, contacta con soporte técnico. Asegúrate de tener una copia de seguridad completa antes de hacerlo.

Paso 7: Verifica la base de datos (opcional pero importante)

Aunque menos común, un error en la base de datos también puede provocar un error 500.

Accede a phpMyAdmin desde cPanel.
Selecciona la base de datos de tu PrestaShop.
Marca la opción "Marcar todas" (Check All).
En el menú desplegable "Con seleccionados", elige "Reparar tabla" (Repair table). Esto intentará reparar cualquier tabla corrupta.
También puedes ejecutar un "Optimizar tabla" después de reparar.

FAQ: Preguntas frecuentes sobre el error 500 en PrestaShop

P: ¿Por qué sigo viendo el error 500 después de todos estos pasos?
R: Puede ser un problema de recursos del servidor (CPU, RAM) o una configuración específica de tu hosting. Contacta con tu proveedor de hosting y diles que has seguido estos pasos. Ellos pueden revisar los logs del servidor (error_log) que a menudo dan la pista definitiva.

P: ¿Puedo usar Syspanel (HestiaCP) para solucionar este error?
R: Sí, los conceptos son los mismos. Si usas Syspanel (HestiaCP), el proceso es similar. Accede a través del puerto 2106 (ejemplo: tudominio.com:2106). Allí encontrarás el Administrador de Archivos y las opciones de PHP (normalmente en "Configuración del servidor" o "PHP"). Los pasos de permisos, .htaccess y modo debug son idénticos.

P: ¿El error 500 puede deberse a una actualización de PHP?
R: ¡Totalmente! Si tu hosting actualizó la versión de PHP de 7.4 a 8.0 o 8.1, muchos módulos y temas antiguos pueden dejar de funcionar y generar un error 500. Desde cPanel, en "Seleccionar versión de PHP", puedes cambiar temporalmente a una versión anterior (por ejemplo, 7.4) para confirmar si ese es el problema. Si es así, deberás actualizar tus módulos y tema.

P: ¿Qué hago si no puedo acceder ni al panel de administración ni al cPanel?
R: Contacta directamente con el soporte de tu empresa de hosting. Ellos tienen acceso root al servidor y pueden revisar los logs o incluso restaurar una copia de seguridad.

Conclusión

Solucionar el error 500 PrestaShop cPanel puede parecer desalentador, pero siguiendo esta guía paso a paso, tendrás muchas posibilidades de resolverlo por ti mismo. Recuerda siempre:

Activar el modo debug para obtener más información.
Revisar el .htaccess (regenerarlo o eliminarlo temporalmente).
Verificar permisos (755 carpetas, 644 archivos).
Aumentar la memoria PHP.
Desactivar módulos y temas conflictivos.
Restaurar archivos del núcleo como último recurso.

Y si todo falla, no dudes en contactar con tu hosting. ¡Buena suerte y que tu tienda vuelva a funcionar pronto!