Error 500 en PrestaShop: Causas y soluciones en cPanel

¿Por qué aparece el error 500 en PrestaShop y qué significa realmente?

Ver un error 500 PrestaShop en tu tienda online es, sin duda, una de las experiencias más frustrantes para cualquier propietario de un negocio digital. La pantalla se queda en blanco, tus clientes no pueden comprar y tú no sabes por dónde empezar a buscar. Pero respira hondo: este error es más común de lo que crees y, en la mayoría de los casos, tiene solución en unos pocos minutos si sabes exactamente dónde mirar.

El error 500, también conocido como "Internal Server Error", es un mensaje genérico que el servidor muestra cuando algo ha fallado internamente pero no quiere (o no puede) darte más detalles. Es como si tu coche se parara en mitad de la carretera y el cuadro de mandos solo te dijera "algo va mal" sin especificar si es el motor, la batería o los frenos.

En el contexto de PrestaShop cPanel error, las causas más habituales suelen ser: archivos con permisos incorrectos, un archivo .htaccess corrupto, problemas de memoria PHP, módulos incompatibles o incluso una actualización fallida. La buena noticia es que, con esta guía paso a paso, podrás solucionar error 500 sin necesidad de ser un experto en programación.

Antes de empezar, ten en cuenta que todo el proceso se realiza desde cPanel, el panel de control que casi todos los hosting ofrecen. Si tu hosting utiliza otro panel como Syspanel (antes conocido como HestiaCP, que se accede por el puerto 2106), los pasos serán muy similares, aunque la interfaz cambie ligeramente.

Paso 1: Localiza el error exacto en los logs del servidor

El primer paso para solucionar error 500 es descubrir qué está fallando exactamente. El mensaje genérico no te dice nada, pero el servidor guarda un registro detallado de todos los errores en los llamados "logs".

Cómo acceder a los logs desde cPanel

Dentro de cPanel, busca la sección "Métricas" o "Registros" (depende de la versión). Normalmente encontrarás una opción llamada "Error Log" o "Registros de errores". Haz clic ahí.

Verás una lista enorme de líneas de texto. No te asustes. Busca las líneas más recientes que contengan la palabra "error" o "fatal". Algo como:

[Thu Oct 10 14:23:45 2024] [error] [client 192.168.1.1] PHP Fatal error: Allowed memory size of 134217728 bytes exhausted

Ese mensaje te está diciendo exactamente qué ha pasado. Los errores más comunes que verás son:

"Allowed memory size exhausted": falta memoria PHP.
"Parse error": hay un fallo de sintaxis en algún archivo PHP.
"Permission denied": problemas de permisos en archivos o carpetas.

[TIP]: Si no encuentras el log fácilmente, puedes crear un archivo llamado php.ini en la raíz de tu PrestaShop y añadir la línea display_errors = On. Esto hará que los errores se muestren directamente en pantalla, aunque no es recomendable dejarlo activo en producción.

Paso 2: Revisa los permisos de archivos y carpetas

Los permisos incorrectos son la causa número uno del error 500 PrestaShop. Cada archivo y carpeta de tu instalación tiene un número de permisos (como 644, 755, etc.) que indica quién puede leer, escribir o ejecutar.

Permisos correctos para PrestaShop

Archivos: deben estar en 644.
Carpetas: deben estar en 755.
La carpeta config/: a veces necesita permisos especiales como 755.
El archivo settings.inc.php: debe estar en 444 o 644 (depende de la versión).

Cómo cambiar permisos desde cPanel

Entra en el Administrador de archivos de cPanel.
Navega hasta la raíz de tu tienda (normalmente public_html).
Selecciona todos los archivos y carpetas (Ctrl+A).
Haz clic derecho y elige "Cambiar permisos".
Marca 644 para archivos y 755 para carpetas.
Aplica los cambios.

[WARNING]: No pongas nunca permisos 777 (todo el mundo puede escribir). Es un riesgo de seguridad grave y muchos hosting lo bloquean automáticamente.

Paso 3: Regenera el archivo .htaccess

El archivo .htaccess es un pequeño archivo de configuración que controla cómo funciona tu servidor web. Si se corrompe o tiene reglas incompatibles, puede provocar un PrestaShop cPanel error al instante.

Cómo regenerar el .htaccess de PrestaShop

Desde el Administrador de archivos de cPanel, navega a la raíz de tu tienda.
Busca el archivo .htaccess (asegúrate de tener activada la opción "Mostrar archivos ocultos").
Renómbralo a algo como .htaccess_backup (por si acaso).
Entra en el Panel de Administración de PrestaShop.
Ve a Parámetros avanzados > Rendimiento.
Busca la opción que dice "Regenerar el archivo .htaccess" y actívala.
Guarda los cambios.

Esto creará un archivo .htaccess nuevo y limpio. Si el problema era ese, el error 500 PrestaShop desaparecerá.

[INFO]: Si no tienes acceso al panel de administración, puedes crear un archivo .htaccess vacío manualmente y luego subirlo. PrestaShop lo regenerará solo al acceder.

Paso 4: Aumenta el límite de memoria PHP

Otro culpable muy frecuente es que el límite de memoria PHP sea demasiado bajo. PrestaShop es una plataforma exigente, y si tu tienda tiene muchos módulos o productos, puede necesitar más memoria de la que el servidor tiene configurada por defecto.

Cómo aumentar la memoria PHP

Desde cPanel, busca la sección "Software" y luego "Select PHP Version" o "Configuración de PHP". Dentro, encontrarás la opción "memory_limit".

El valor recomendado para PrestaShop es al menos 256M.
Si puedes, pon 512M para estar más tranquilo.

También puedes editarlo manualmente creando un archivo php.ini en la raíz con el siguiente contenido:

memory_limit = 256M
max_execution_time = 120
max_input_vars = 5000

El max_input_vars es especialmente importante si tienes muchos productos con muchas combinaciones, porque un valor bajo puede provocar errores extraños.

Paso 5: Desactiva o repara módulos conflictivos

Si el error empezó después de instalar o actualizar un módulo, es muy probable que ese módulo sea el responsable. Los módulos mal codificados o incompatibles con tu versión de PrestaShop pueden tirar toda la tienda abajo.

Cómo identificar un módulo problemático

Accede a tu panel de administración de PrestaShop.
Ve a Módulos > Gestor de Módulos.
Ordena la lista por "Últimamente actualizados" o "Instalados recientemente".
Desactiva los módulos sospechosos uno a uno, guardando los cambios y comprobando si el error desaparece.

[TIP]: Si no puedes acceder al panel de administración, renombra la carpeta del módulo sospechoso en el servidor (dentro de /modules/). Si el error desaparece, ese era el problema.

Paso 6: Verifica si el problema viene de una actualización fallida

Las actualizaciones de PrestaShop (tanto de la versión principal como de los módulos) a veces fallan a mitad de camino, dejando archivos a medias que provocan el error 500 PrestaShop.

Qué hacer si sospechas de una actualización fallida

Revisa si hay archivos temporales en la carpeta /admin/autoupgrade/.
Si existen, haz una copia de seguridad y elimínalos.
Vuelve a subir los archivos de la versión de PrestaShop que estabas usando (puedes descargarlos desde tu cuenta de PrestaShop).
Asegúrate de subir los archivos en modo ASCII (no binario) si usas un cliente FTP.

Paso 7: Revisa los logs de error del servidor web (Apache)

A veces el error no viene de PHP sino del propio servidor web. En cPanel, busca "Apache Handler" o "Status del servidor" para ver si hay algo raro.

También puedes revisar el "Raw Access Log" que encontrarás en la sección de métricas. Ahí verás las peticiones que se han hecho a tu web y el código de error que ha devuelto cada una.

Paso 8: Prueba con un archivo de prueba PHP

Para descartar que el problema sea de PrestaShop en sí y no del servidor, crea un archivo de prueba sencillo:

Ve al Administrador de archivos de cPanel.
Crea un archivo nuevo en la raíz llamado test.php.
Edítalo y pega este código:

<?php
echo "El servidor funciona correctamente";
phpinfo();
?>

Accede a tudominio.com/test.php en tu navegador.

Si ves el mensaje y la información de PHP, el servidor está bien y el problema es exclusivo de PrestaShop. Si ni siquiera esto funciona, el fallo es del hosting y deberías contactar con tu proveedor.

[WARNING]: No olvides eliminar test.php después de hacer la prueba. Dejar un archivo con phpinfo() expuesto es un riesgo de seguridad.

Paso 9: Comprueba los permisos de la carpeta var/cache

PrestaShop utiliza una carpeta de caché para acelerar la carga de las páginas. Si esta carpeta tiene permisos incorrectos o está llena de archivos corruptos, puede provocar errores.

Limpiar la caché manualmente

Ve a /var/cache/ en la raíz de tu PrestaShop.
Elimina todo el contenido de las carpetas dev y prod (no las carpetas en sí, solo su interior).
Asegúrate de que la carpeta cache tenga permisos 755.

También puedes limpiar la caché desde el panel de administración en Parámetros avanzados > Rendimiento > Vaciar la caché.

Paso 10: Contacta con tu proveedor de hosting

Si después de todos estos pasos el error 500 PrestaShop sigue apareciendo, es hora de pedir ayuda profesional. Los problemas de configuración del servidor, como versiones de PHP incompatibles o módulos de Apache desactivados, solo pueden solucionarlos ellos.

Qué información dar a tu soporte técnico

Captura de pantalla del error exacto.
El contenido de los logs de error (al menos las últimas líneas).
La versión de PrestaShop y de PHP que usas.
Qué cambios hiciste justo antes de que apareciera el error.

Preguntas frecuentes sobre el error 500 en PrestaShop

¿El error 500 siempre es culpa de mi hosting?

No. En la mayoría de los casos es un problema de configuración de tu propia instalación de PrestaShop, como permisos incorrectos o un módulo incompatible.

¿Puedo perder datos si intento arreglarlo yo mismo?

Si sigues los pasos de esta guía, no deberías perder datos. Eso sí, antes de tocar nada, haz siempre una copia de seguridad completa de tu tienda (archivos y base de datos) desde cPanel.

¿Cuánto tiempo se tarda en solucionar?

Depende de la causa. Los problemas de permisos se arreglan en 5 minutos. Un módulo conflictivo puede llevarte 30 minutos de prueba y error. Si es cosa del hosting, puede tardar horas.

¿Por qué aparece el error solo en algunas páginas?

Si el error aparece solo al acceder a ciertas páginas (por ejemplo, la ficha de un producto), el problema suele estar en un módulo específico o en un campo de la base de datos corrupto.

¿Debo actualizar PrestaShop a la última versión?

Mantener PrestaShop actualizado es buena práctica, pero las actualizaciones también pueden introducir errores si no se hacen correctamente. Asegúrate de tener una copia de seguridad antes de actualizar.

Resumen final: checklist para solucionar el error 500

Para que no se te olvide nada, aquí tienes el resumen de todos los pasos que debes seguir en orden:

Revisa los logs para saber qué está fallando exactamente.
Corrige los permisos de archivos (644) y carpetas (755).
Regenera el .htaccess desde el panel de administración.
Aumenta la memoria PHP a 256M o más.
Desactiva módulos recientes o sospechosos.
Limpia la caché de PrestaShop.
Comprueba si el servidor funciona con un archivo de prueba.
Contacta con tu hosting si todo lo demás falla.

[INFO]: Si tu hosting usa Syspanel (el panel que antes se llamaba HestiaCP), recuerda que el acceso se hace a través del puerto 2106. Los pasos son prácticamente los mismos, pero la interfaz tendrá nombres diferentes. Busca las secciones de "Archivos", "Logs" y "PHP" y verás que todo encaja.

El error 500 PrestaShop puede parecer un muro infranqueable al principio, pero con paciencia y siguiendo esta guía paso a paso, tendrás tu tienda funcionando de nuevo en muy poco tiempo. Recuerda siempre hacer copias de seguridad antes de tocar nada y no dudes en pedir ayuda si te sientes perdido. ¡Tu tienda online te lo agradecerá!