Error 500 PrestaShop cPanel | Cómo solucionarlo rápido

Introducción: ¿Qué significa el error 500 en PrestaShop y por qué aparece en cPanel?

Si estás leyendo esto, probablemente te has encontrado con la temida pantalla blanca o el mensaje "Error 500 – Internal Server Error" al intentar acceder a tu tienda PrestaShop. No te preocupes, es uno de los problemas más comunes en el mundo del hosting y, aunque parece grave, en la mayoría de los casos tiene solución. Este error es genérico: significa que el servidor web (Apache, Nginx, LiteSpeed, etc.) encontró un problema interno que le impide procesar tu solicitud, pero no te da detalles específicos.

En el contexto de PrestaShop con cPanel, las causas más frecuentes suelen ser: archivos de configuración corruptos (como .htaccess), problemas con los permisos de archivos y carpetas, módulos conflictivos, límites de memoria PHP insuficientes, o errores en el archivo config/defines.inc.php. También puede deberse a un plugin de caché mal configurado o a un tema que no es compatible con tu versión de PrestaShop.

En esta guía paso a paso, te enseñaré cómo solucionar error 500 PrestaShop usando las herramientas que ofrece cPanel, sin necesidad de ser un experto técnico. Seguiremos un orden lógico: desde lo más simple (revisar el .htaccess) hasta soluciones más avanzadas (aumentar memoria PHP o depurar el log de errores). Al final, tendrás un checklist claro para resolver este problema por ti mismo.

¿Por qué es importante actuar rápido?

Un error 500 en tu tienda PrestaShop no solo bloquea a tus clientes, sino que también puede afectar tu posicionamiento SEO si se mantiene por horas. Google penaliza las páginas con errores frecuentes, así que cuanto antes lo soluciones, mejor. Además, si usas cPanel, tienes acceso directo a herramientas como el administrador de archivos, el gestor de bases de datos y los logs de errores, que serán tus mejores aliados.

Requisitos previos antes de empezar

Antes de lanzarte a modificar archivos, asegúrate de tener:

Acceso a cPanel (usuario y contraseña).
Una copia de seguridad reciente de tu tienda (archivos y base de datos). Siempre es mejor prevenir.
Conexión estable a internet y algo de paciencia.

[WARNING] No modifiques archivos sin hacer una copia de seguridad previa. Un cambio incorrecto podría agravar el problema o dejarte sin tienda.

Paso 1: Identificar la causa raíz – Revisar los logs de error en cPanel

Lo primero es saber qué está pasando exactamente. El error 500 no da detalles, pero el servidor guarda un registro de errores. En cPanel puedes acceder a ellos fácilmente.

Cómo acceder a los logs de error en cPanel:

Inicia sesión en tu cPanel (normalmente en tudominio.com/cpanel).
Busca la sección "Métricas" o "Registros" y haz clic en "Registros de errores" (o "Error Log" en inglés).
Se abrirá una lista con las últimas entradas. Busca líneas que contengan la fecha y hora en que apareció el error 500.
Lee el mensaje de error. Algunos ejemplos comunes:
- PHP Fatal error: Allowed memory size of XXX bytes exhausted → Problema de memoria PHP.
- PHP Fatal error: Uncaught exception → Error en un módulo o tema.
- File does not exist: /home/usuario/public_html/.htaccess → Archivo .htaccess corrupto o faltante.

[TIP] Si no ves nada en el log, activa el modo debug de PrestaShop temporalmente (lo explicamos más adelante).

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

El archivo .htaccess es un archivo de configuración que Apache (o el servidor web) lee en cada solicitud. Si está dañado, mal escrito o tiene reglas incompatibles, provoca un error 500.

Pasos para restaurar el .htaccess:

En cPanel, ve a "Administrador de archivos" (File Manager).
Navega hasta la carpeta raíz de tu tienda (normalmente public_html).
Busca el archivo .htaccess. Ojo: puede estar oculto. Activa la opción "Mostrar archivos ocultos" (Show Hidden Files) en la parte superior.
Haz una copia de seguridad: haz clic derecho sobre .htaccess y selecciona "Copiar". Pégalo en una carpeta temporal (por ejemplo, copia_seguridad).
Ahora, elimina el archivo original (puedes arrastrarlo a la papelera o usar la opción "Eliminar").
Vuelve a tu tienda PrestaShop en el navegador y recarga la página. Si el error desaparece, el problema era el .htaccess.
Para regenerar uno nuevo y limpio, entra al panel de administración de PrestaShop (si puedes acceder) y ve a Configuración de la tienda > Rendimiento. Allí busca la opción "Regenerar el archivo .htaccess" y actívala.
Si no puedes acceder al panel, puedes crear un .htaccess básico manualmente. Crea un archivo nuevo en el Administrador de archivos con el siguiente contenido:

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

Guárdalo como .htaccess (sin extensión .txt) y pruébalo.

[INFO] Si usas Syspanel (el panel de control alternativo a cPanel, que se accede por el puerto 2106), el proceso es similar: busca el administrador de archivos y sigue los mismos pasos.

Paso 3: Verificar y corregir los permisos de archivos y carpetas

Los permisos incorrectos son otra causa común del error 500 en PrestaShop. Cada archivo y carpeta tiene un número que indica quién puede leer, escribir o ejecutar. PrestaShop necesita permisos específicos.

Permisos recomendados para PrestaShop:

Archivos: 644 (lectura/escritura para el propietario, solo lectura para grupo y otros).
Carpetas: 755 (lectura/escritura/ejecución para propietario, lectura/ejecución para grupo y otros).
Archivos de configuración sensibles (como config/settings.inc.php): 444 o 644, pero nunca 777.

Cómo cambiar permisos desde cPanel:

En el Administrador de archivos, selecciona todos los archivos y carpetas de tu tienda (puedes usar Ctrl+A).
Haz clic en "Permisos" (o "Change Permissions").
Marca las casillas correspondientes:
- Para archivos: propietario: lectura + escritura; grupo: solo lectura; otros: solo lectura.
- Para carpetas: propietario: todo; grupo: lectura + ejecución; otros: lectura + ejecución.
Aplica los cambios. Puede tardar unos segundos si hay muchos archivos.

[WARNING] Nunca pongas permisos 777 en archivos de PrestaShop, ya que es un riesgo de seguridad. Solo usa 755 para carpetas y 644 para archivos.

Paso 4: Aumentar el límite de memoria PHP

El error "Allowed memory size exhausted" es muy común en PrestaShop, sobre todo si tienes muchos módulos o catálogos grandes. Para solucionarlo, debes aumentar el límite de memoria PHP.

Desde cPanel:

Ve a "Seleccionar versión de PHP" (Select PHP Version) dentro de la sección Software.
Haz clic en "Opciones" (Options) o "Switch to PHP Options".
Busca la variable memory_limit y cámbiala a un valor más alto, por ejemplo 256M o 512M. También puedes ajustar max_execution_time a 300 y upload_max_filesize a 64M.
Guarda los cambios.

Si no tienes acceso a esa opción (hosting compartido básico):

Puedes intentar añadir una línea en el archivo config/defines.inc.php de PrestaShop. Pero cuidado: este archivo es crítico.

Ve al Administrador de archivos y abre config/defines.inc.php.
Busca la línea que dice define('_PS_MODE_DEV_', false); (o similar).
Justo encima, añade: ini_set('memory_limit', '256M');
Guarda y recarga la tienda.

[TIP] Si después de esto el error persiste, contacta a tu proveedor de hosting. Algunos limitan la memoria a nivel de servidor y no se puede cambiar desde cPanel.

Paso 5: Deshabilitar módulos conflictivos (modo seguro)

A veces un módulo recién instalado o actualizado causa un error 500. Para identificarlo, puedes deshabilitar todos los módulos no esenciales.

Método rápido sin acceso al panel:

En el Administrador de archivos, navega hasta modules/ dentro de tu tienda.
Renombra la carpeta del módulo sospechoso añadiendo _old al final (por ejemplo, ps_facebook_old). Esto lo desactiva.
Recarga la tienda. Si el error desaparece, ese módulo era el culpable.
Si no sabes cuál es, puedes renombrar todas las carpetas de módulos a la vez (menos las esenciales como ps_mainmenu o ps_themeconfigurator). Luego ve activándolos uno por uno.

Desde el panel de administración (si puedes acceder):

Ve a Módulos > Catálogo de módulos y desactiva los módulos no utilizados o los que instalaste recientemente.

Paso 6: Activar el modo debug de PrestaShop para obtener más pistas

Si los logs de cPanel no muestran nada útil, activa el modo debug de PrestaShop. Esto mostrará el error detallado en pantalla.

Cómo activarlo:

Abre el archivo config/defines.inc.php en el Administrador de archivos.
Busca la línea: define('_PS_MODE_DEV_', false);
Cámbiala a: define('_PS_MODE_DEV_', true);
Guarda y recarga la tienda. Ahora verás un mensaje de error más descriptivo (por ejemplo, "Fatal error: Call to undefined method...").
Una vez resuelto el problema, vuelve a poner false para evitar que los clientes vean errores internos.

[WARNING] No dejes el modo debug activado en producción, ya que expone información sensible.

Paso 7: Comprobar la versión de PHP y la compatibilidad

PrestaShop requiere una versión específica de PHP. Si tu hosting actualizó PHP a una versión no soportada (por ejemplo, PHP 8.2 con PrestaShop 1.6), tendrás error 500.

Desde cPanel:

Ve a "Seleccionar versión de PHP".
Elige una versión compatible con tu PrestaShop:
- PrestaShop 1.6: PHP 5.6 o 7.0 (mejor 7.0).
- PrestaShop 1.7: PHP 7.1 a 7.4 (recomendado 7.4).
- PrestaShop 8.x: PHP 7.4 o 8.1.
Guarda y prueba.

Paso 8: Revisar la base de datos (en casos extremos)

Aunque menos común, una base de datos corrupta puede dar error 500. Puedes repararla desde cPanel:

Ve a "phpMyAdmin" dentro de la sección Bases de datos.
Selecciona la base de datos de tu tienda.
En la pestaña "Operaciones", busca "Reparar tabla" o "Optimizar tabla".
Ejecuta la reparación.

[INFO] Si no te sientes cómodo con phpMyAdmin, pide ayuda a tu hosting. También puedes usar la herramienta "Reparar base de datos" de PrestaShop (si accedes al panel, en Parámetros avanzados > Base de datos).

FAQ – Preguntas frecuentes sobre el error 500 en PrestaShop con cPanel

1. ¿El error 500 puede deberse a un ataque de seguridad?

Sí, a veces un archivo infectado o un intento de hacking puede corromper archivos y provocar el error. Si después de seguir todos los pasos el problema persiste, revisa si hay archivos sospechosos (como .php en carpetas de imágenes) y escanea con un plugin de seguridad.

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

Sigue los pasos de esta guía usando solo cPanel (Administrador de archivos, logs, etc.). Si todo falla, restaura una copia de seguridad de tus archivos y base de datos.

3. ¿El error 500 afecta mi SEO?

Sí, si el error se mantiene por horas o días, Google puede desindexar tus páginas o penalizar tu posicionamiento. Soluciónalo lo antes posible.

4. ¿Puedo usar Syspanel para solucionar el error 500?

Sí, si tu hosting usa Syspanel (acceso por puerto 2106), las herramientas son equivalentes a cPanel. Busca el administrador de archivos, logs de errores y gestor de PHP. El proceso es el mismo.

5. ¿Debo contactar a mi hosting?

Si después de probar todos los pasos el error continúa, contacta a tu proveedor. Puede ser un problema de configuración del servidor (como un módulo de Apache deshabilitado) que solo ellos pueden arreglar.

Conclusión y checklist final

El error 500 en PrestaShop con cPanel puede parecer aterrador, pero siguiendo este orden lógico podrás resolverlo en la mayoría de los casos. Aquí tienes un resumen rápido:

Revisa los logs de error en cPanel.
Restaura o regenera el archivo .htaccess.
Corrige los permisos de archivos (644) y carpetas (755).
Aumenta el límite de memoria PHP.
Desactiva módulos conflictivos.
Activa el modo debug para más pistas.
Verifica la versión de PHP.
Repara la base de datos si es necesario.

Recuerda siempre tener una copia de seguridad. ¡No te rindas! La mayoría de las veces es un problema sencillo de solucionar. Si te quedas atascado, busca ayuda en foros de PrestaShop o en el soporte de tu hosting. ¡Buena suerte con tu tienda!