Solucionar error 500 en PrestaShop con cPanel | FAQ técnico

¿Tu tienda PrestaShop muestra un molesto error 500 y no sabes por dónde empezar? Tranquilo, es uno de los problemas más comunes en entornos de hosting y, aunque parece grave, en la mayoría de los casos se soluciona con unos pocos pasos. En esta guía completa y fácil de seguir, te explicaré cómo solucionar error 500 en cPanel para tu PrestaShop, paso a paso, sin necesidad de ser un experto en Linux.

El error 500 (Internal Server Error) es un mensaje genérico que indica que algo falló en el servidor, pero no especifica qué. Puede deberse a un archivo .htaccess corrupto, un plugin incompatible, falta de memoria o incluso un permiso de archivo incorrecto. Como técnico de soporte, te aseguro que la mayoría de las soluciones son sencillas y no requieren tocar código complejo.

¿Qué causa el error 500 en PrestaShop?

Antes de lanzarnos a solucionarlo, es útil entender las causas más frecuentes. Esto te ayudará a identificar el problema más rápido.

[INFO] El error 500 en PrestaShop suele aparecer al instalar un módulo, cambiar de tema, modificar archivos de configuración o después de una actualización.

Las razones principales incluyen:

Archivo .htaccess dañado (el más común).
Permisos de archivos incorrectos (por ejemplo, archivos con permisos 777 cuando deberían ser 644).
Límite de memoria PHP excedido (memory_limit muy bajo).
Módulo o tema incompatible que genera un error fatal.
Problemas con la versión de PHP (incompatible con PrestaShop).
Archivos de caché corruptos en /var/cache/ o /cache/.
Error en el archivo settings.inc.php (configuración de base de datos).

Paso 1: Accede a cPanel y activa el modo debug de PrestaShop

Lo primero es obtener más información sobre el error. El mensaje genérico "500" no ayuda, pero PrestaShop tiene un modo debug que revela el error exacto.

¿Cómo activar el modo debug?

Accede a tu cPanel (normalmente en tudominio.com/cpanel).
Ve a Administrador de archivos (File Manager) y navega a la carpeta raíz de tu PrestaShop (normalmente public_html).
Busca el archivo config/defines.inc.php.
Haz clic derecho y selecciona Editar.
Busca la línea:
define('_PS_MODE_DEV_', false);
Cámbiala a:
define('_PS_MODE_DEV_', true);
Guarda los cambios.

[WARNING] No olvides desactivar el modo debug después de solucionar el error. Si lo dejas activo, tu tienda mostrará mensajes técnicos a los visitantes.

Ahora, al recargar tu tienda, verás un mensaje de error detallado (como "Fatal error: Allowed memory size exhausted" o "Parse error"). Anota ese mensaje, te guiará directamente a la solución.

Paso 2: Soluciona el error según el mensaje obtenido

Dependiendo del mensaje de error, aplica la solución correspondiente.

Si ves "Allowed memory size of X bytes exhausted"

Esto significa que el límite de memoria PHP es muy bajo. PrestaShop necesita al menos 128 MB, pero recomendamos 256 MB o más.

Cómo aumentarlo desde cPanel:

En cPanel, busca la sección Software y haz clic en Seleccionar versión de PHP (o MultiPHP Manager).
Dentro, verás una opción Switch to PHP Options o Extensiones.
Busca el parámetro memory_limit y cámbialo a 256M o 512M.
Guarda y recarga tu tienda.

[TIP] Si no encuentras la opción, puedes crear un archivo php.ini en la raíz de PrestaShop con el contenido: memory_limit = 256M.

Si ves "Parse error" o "Syntax error"

Esto indica un error en un archivo PHP, normalmente por un módulo o tema mal codificado.

Pasos para identificarlo:

El mensaje incluirá la ruta del archivo, por ejemplo:
/public_html/modules/mimodulo/mimodulo.php
Desactiva temporalmente el módulo renombrando la carpeta del módulo desde File Manager. Por ejemplo, cambia mimodulo a mimodulo_desactivado.
Vuelve a cargar la tienda. Si el error desaparece, el módulo era el culpable. Contacta al desarrollador.

Si ves "Headers already sent"

Esto suele deberse a espacios en blanco o caracteres extra al final de archivos PHP, especialmente en config/defines.inc.php o settings.inc.php.

Solución:

Abre el archivo mencionado en el error.
Revisa que no haya espacios, saltos de línea o caracteres invisibles después del ?> final. Si lo hay, bórralos.
Guarda el archivo sin la etiqueta de cierre ?> (es buena práctica omitirla en archivos PHP puros).

Paso 3: Restaura el archivo .htaccess (causa más común)

El archivo .htaccess de PrestaShop es delicado. Si se corrompe (por ejemplo, al instalar un módulo de redirección), genera error 500.

Cómo restaurarlo desde cPanel:

En Administrador de archivos, ve a la raíz de PrestaShop.
Busca el archivo .htaccess (puede estar oculto; activa "Mostrar archivos ocultos" en la configuración).
Renómbralo a .htaccess_old (esto lo desactiva).
Ahora, ve al back office de PrestaShop (si puedes acceder):
- Ve a Configuración de la tienda > Tráfico y SEO > URL amigables.
- Haz clic en Guardar sin cambiar nada. Esto regenera el .htaccess automáticamente.
Si no puedes acceder al back office, crea un .htaccess nuevo desde cero:

# START PrestaShop
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [QSA,L]
</IfModule>
# END PrestaShop

Guarda este contenido en un archivo llamado .htaccess y súbelo a la raíz.

[WARNING] No copies el código de ejemplo sin adaptarlo. Si tu tienda está en una subcarpeta (ej: public_html/tienda), cambia RewriteBase / por RewriteBase /tienda/.

Paso 4: Verifica los permisos de archivos y carpetas

Los permisos incorrectos son otra causa frecuente. PrestaShop necesita permisos específicos para funcionar.

Permisos recomendados:

Archivos (PHP, JS, CSS): 644
Carpetas: 755
Archivos de configuración (settings.inc.php, defines.inc.php): 644
Carpeta cache y log: 755 (a veces 777 temporalmente)

Cómo corregirlos desde cPanel:

En Administrador de archivos, selecciona la carpeta raíz de PrestaShop.
Haz clic en Seleccionar todo (o Ctrl+A).
Arriba, haz clic en Permisos.
Cambia a 644 para archivos y 755 para carpetas. Marca la opción Recursivo para aplicar a subcarpetas.
Haz clic en Aceptar.

Si después de esto el error persiste, prueba dando permisos 777 temporalmente a las carpetas cache, log y config (solo para pruebas, luego revierte).

Paso 5: Limpia la caché de PrestaShop

La caché corrupta puede generar errores 500, especialmente después de actualizaciones.

Desde cPanel (sin acceso al back office):

Ve a la carpeta raíz de PrestaShop.
Entra en la carpeta /var/cache/ (o /cache/ en versiones antiguas).
Selecciona todos los archivos y carpetas dentro y elimínalos (no borres la carpeta en sí).
Si existe, también borra el contenido de /cache/smarty/.
Recarga la tienda.

[TIP] Si no puedes borrar algunos archivos, cámbiales los permisos a 777 primero.

Paso 6: Verifica la versión de PHP

PrestaShop 1.7 requiere PHP 7.1 a 8.0 (ideal 7.4). Versiones más nuevas (8.1+) pueden causar errores si no están actualizados los módulos.

Cómo cambiarla desde cPanel:

Ve a Seleccionar versión de PHP (o MultiPHP Manager).
Elige PHP 7.4 (es la más estable para PrestaShop 1.7).
Guarda y prueba.

Si usas Syspanel (HestiaCP), el puerto de acceso es el 2106. Allí puedes cambiar la versión de PHP desde la sección de configuración del dominio.

Paso 7: Revisa el archivo settings.inc.php

Este archivo contiene la conexión a la base de datos. Si está dañado, PrestaShop no arranca.

Cómo verificarlo:

Ve a config/settings.inc.php (o app/config/parameters.php en PrestaShop 1.7+).
Ábrelo con el editor de texto.
Verifica que los datos de la base de datos sean correctos:
- _DB_SERVER_ (normalmente localhost)
- _DB_NAME_
- _DB_USER_
- _DB_PASSWD_
Si ves caracteres extraños o la contraseña está en blanco, restaura una copia de seguridad de este archivo.

[INFO] Si no tienes copia, puedes regenerar los datos desde la herramienta phpMyAdmin en cPanel, pero es más seguro restaurar un backup completo.

Preguntas frecuentes (FAQ PrestaShop)

Aquí respondemos las dudas más comunes de quienes buscan solucionar error 500 cPanel en PrestaShop.

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

Los módulos mal codificados o incompatibles con tu versión de PHP suelen generar errores fatales. Desactiva el módulo renombrando su carpeta en /modules/. Si el error desaparece, contacta al desarrollador.

¿El error 500 puede deberse a un tema?

Sí, especialmente temas que no están actualizados. Prueba cambiando temporalmente al tema predeterminado (por ejemplo, classic en PrestaShop 1.7) desde el back office o editando la base de datos.

¿Cómo puedo saber la versión de PHP que usa mi PrestaShop?

En cPanel, ve a Seleccionar versión de PHP. También puedes crear un archivo info.php en la raíz con <?php phpinfo(); ?> y acceder a tudominio.com/info.php. No olvides borrarlo después por seguridad.

¿Qué hago si no tengo acceso al back office de PrestaShop?

Puedes solucionar todo desde cPanel (File Manager, phpMyAdmin, etc.). Si el error es de base de datos, usa phpMyAdmin para reparar tablas o restaurar un backup.

¿El error 500 puede ser por un plugin de caché como Varnish?

Sí, a veces Varnish o Cloudflare guardan en caché páginas con errores. Limpia la caché de tu CDN y desactívalo temporalmente para probar.

Resumen final

El error 500 en PrestaShop puede parecer aterrador, pero siguiendo estos pasos lo resolverás en minutos. Recuerda:

Activa el modo debug para ver el error exacto.
Aumenta el memory_limit si es necesario.
Restaura el .htaccess (es la causa más común).
Corrige permisos de archivos y carpetas.
Limpia la caché.
Verifica la versión de PHP y los archivos de configuración.

Si después de todo esto el error persiste, contacta a tu proveedor de hosting. Ellos pueden revisar los logs del servidor (error_log) que suelen estar en la raíz de PrestaShop o en /logs/ de cPanel.

[TIP] Siempre mantén una copia de seguridad reciente de tu tienda. Así, si algo sale mal, puedes restaurarla en minutos.

Espero que esta guía te haya sido útil. ¡Tu tienda PrestaShop volverá a funcionar en poco tiempo! Si tienes más dudas, revisa nuestra sección de FAQ PrestaShop o escribe a soporte.