Error 500 en PrestaShop en cPanel: Causas comunes y cómo solucionarlo

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

Si estás administrando una tienda online con PrestaShop y de repente ves una pantalla en blanco o un mensaje como "Error interno del servidor 500", no te preocupes: es uno de los problemas más comunes en entornos de hosting compartido, y por suerte, casi siempre tiene solución. En este artículo te explicaré paso a paso cómo solucionar error 500 PrestaShop cuando tu sitio está alojado en un panel de control como cPanel o Syspanel (recuerda que Syspanel es el nombre de HestiaCP y suele accederse por el puerto 2106).

El error 500 PrestaShop cPanel es un error genérico del servidor. Significa que algo falló en la configuración de tu tienda, en los archivos del sistema o en los permisos, pero el servidor no puede darte más detalles por seguridad. Por eso, tendremos que investigar nosotros mismos.

Causas más frecuentes del error 500 en PrestaShop

Antes de lanzarnos a solucionar, es importante entender qué puede estar provocando este error. Las causas más habituales son:

Archivo .htaccess corrupto o mal configurado (muy común al mover la tienda o instalar módulos).
Permisos de archivos o carpetas incorrectos (por ejemplo, después de una restauración o actualización).
Problemas de memoria PHP (límite de memoria insuficiente para ejecutar PrestaShop).
Módulos o temas incompatibles (especialmente tras una actualización de PrestaShop).
Errores en el archivo de configuración de la base de datos (settings.inc.php).
PHP no compatible (versión de PHP desactualizada o incorrecta para tu PrestaShop).

Paso 1: Activar el modo debug de PrestaShop (la clave para entender el error)

Cuando tu tienda muestra un error 500 sin más detalles, lo primero que debes hacer es activar el modo debug de PrestaShop. Esto hará que aparezca el mensaje de error real en lugar de la pantalla en blanco.

¿Cómo activar el modo debug?

Accede a tu panel de control (cPanel o Syspanel en puerto 2106).
Ve al Administrador de archivos (File Manager).
Localiza la carpeta raíz de tu PrestaShop (normalmente public_html o una subcarpeta si la tienda está en un subdominio).
Busca el archivo config/defines.inc.php.
Edítalo con el editor de texto del panel.
Busca la línea que dice:
```
define('_PS_MODE_DEV_', false);
```
Cámbiala por:
```
define('_PS_MODE_DEV_', true);
```
Guarda el archivo.

Ahora, al recargar tu tienda, verás un mensaje de error más descriptivo. Por ejemplo, puede decir "Fatal error: Allowed memory size exhausted" o "Class not found". Anota ese mensaje, porque te guiará hacia la solución.

[TIP] Si no encuentras el archivo defines.inc.php, asegúrate de que estás viendo archivos ocultos. En cPanel, hay un botón "Mostrar archivos ocultos" (dotfiles). En Syspanel, también puedes verlos desde el administrador de archivos.

Paso 2: Solucionar problemas con el archivo .htaccess

El archivo .htaccess es uno de los principales sospechosos. Si está dañado, PrestaShop no podrá funcionar correctamente.

Solución: renombrar o eliminar el .htaccess

En el administrador de archivos, busca el archivo .htaccess en la raíz de tu PrestaShop.
Renómbralo a algo como .htaccess_old (esto lo desactiva).
Recarga tu tienda. Si el error 500 desaparece, el problema era el .htaccess.
Para regenerarlo correctamente:
- Ve al Back Office de PrestaShop (si puedes acceder) o directamente a la URL tudominio.com/index.php?controller=AdminLogin.
- Una vez dentro, ve a Configuración → Parámetros de la tienda → Configuración de tráfico y SEO.
- En la pestaña URLs amigables, haz clic en Guardar (aunque no hayas cambiado nada). Esto regenera el .htaccess automáticamente.

[WARNING] Si no puedes acceder ni al Back Office, prueba a crear un .htaccess nuevo desde cero con el contenido básico de PrestaShop. Puedes descargar uno de una instalación limpia o pedírselo a tu soporte técnico.

Paso 3: Verificar y corregir permisos de archivos

Los permisos incorrectos son otra causa común del error 500. PrestaShop necesita permisos específicos para funcionar.

Permisos recomendados:

Tipo	Permiso
Carpetas	755
Archivos	644
Archivo `config/settings.inc.php`	644 (o 444 si funciona)

¿Cómo cambiarlos?

En cPanel o Syspanel, selecciona todas las carpetas y archivos de tu PrestaShop.
Usa la opción Cambiar permisos (puede estar en el menú derecho o en la barra superior).
Aplica 755 a las carpetas y 644 a los archivos.

[INFO] Si tienes problemas con la herramienta gráfica, puedes usar el comando find desde el terminal SSH (si tu hosting lo permite). Pero para usuarios sin experiencia, el administrador de archivos es suficiente.

Paso 4: Aumentar el límite de memoria PHP

Si el error dice algo como "Allowed memory size of X bytes exhausted", necesitas aumentar el límite de memoria PHP.

Opción A: Desde cPanel (recomendado)

En cPanel, busca la sección Seleccionar versión de PHP (o MultiPHP Manager).
Haz clic en Cambiar a opciones avanzadas o Switch to PHP Options.
Busca la opción memory_limit y cámbiala a 256M o incluso 512M.
Guarda los cambios.

Opción B: Desde Syspanel (HestiaCP)

Accede a Syspanel por el puerto 2106.
Ve a Web → Dominios → selecciona tu dominio.
Busca la opción Configuración de PHP o PHP-FPM.
Ajusta el valor memory_limit a 256M.

Opción C: Manualmente (si no tienes acceso a la configuración)

Crea un archivo llamado php.ini en la raíz de tu PrestaShop.
Escribe dentro:
```
memory_limit = 256M
```
Guárdalo y recarga la tienda.

[TIP] Si el error persiste, prueba con 512M. Pero no te pases, porque puede afectar el rendimiento del servidor.

Paso 5: Desactivar módulos o temas problemáticos

A veces, un módulo recién instalado o un tema incompatible rompe la tienda. El error 500 puede aparecer justo después de instalar algo.

¿Cómo desactivar módulos si no puedes acceder al Back Office?

Conéctate a tu base de datos desde phpMyAdmin (en cPanel o Syspanel).
Busca la tabla ps_module (el prefijo puede ser diferente, por ejemplo prestashop_module).
Localiza el módulo sospechoso (por su nombre) y cambia su estado de 1 a 0 en la columna active.
Si no sabes cuál es, puedes desactivar todos los módulos no esenciales cambiando active = 0 en varios registros.

Otra opción más sencilla: renombrar la carpeta del módulo desde el administrador de archivos. Por ejemplo, si el módulo se llama mimodulo, renómbralo a mimodulo_old. Al recargar, PrestaShop no lo cargará y el error podría desaparecer.

Paso 6: Revisar el archivo de configuración de la base de datos

El archivo config/settings.inc.php contiene la conexión a la base de datos. Si está dañado o tiene credenciales incorrectas, obtendrás un error 500.

¿Cómo verificarlo?

Abre el archivo config/settings.inc.php desde el administrador de archivos.

Busca las líneas:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_base');
define('_DB_USER_', 'usuario');
define('_DB_PASSWD_', 'contraseña');

Asegúrate de que los datos coinciden con los de tu base de datos real. Puedes obtenerlos desde cPanel (sección Bases de datos MySQL) o desde Syspanel (base de datos).
Si cambiaste algo, guarda el archivo.

[WARNING] Ten cuidado al editar este archivo. Un error de sintaxis (como una comilla mal puesta) puede causar más problemas. Si no estás seguro, haz una copia de seguridad antes.

Paso 7: Verificar la versión de PHP

PrestaShop 1.6 y versiones anteriores funcionan bien con PHP 5.6 o 7.0, mientras que PrestaShop 1.7 y 8 requieren PHP 7.1 o superior (idealmente 7.4 o 8.0). Una versión incorrecta puede provocar error 500.

¿Cómo cambiar la versión de PHP?

En cPanel: Ve a Seleccionar versión de PHP y elige la recomendada para tu PrestaShop.
En Syspanel: Desde la configuración del dominio, busca Versión de PHP y selecciona la adecuada.

Preguntas frecuentes (FAQ)

¿Qué hago si después de todo sigue el error 500?

Si has seguido todos los pasos y el error persiste, puede ser un problema del servidor (memoria insuficiente, configuración de Apache, etc.). Contacta a tu proveedor de hosting y diles que has revisado los puntos anteriores.

¿El error 500 puede deberse a un plugin de caché?

Sí, a veces los plugins de caché (como los de PrestaShop o los del servidor) guardan datos corruptos. Prueba a limpiar la caché desde el Back Office o eliminando manualmente la carpeta var/cache (en PrestaShop 1.7) o cache (en PrestaShop 1.6).

¿Cómo sé si es un problema de la base de datos?

Si el error aparece al acceder a páginas que requieren consultas (como el catálogo), pero no en la página de inicio, puede ser un problema de base de datos. Revisa los logs de errores en cPanel (sección Errores o Logs) o en Syspanel (sección Logs del sistema).

¿Debo restaurar una copia de seguridad?

Si todo falla, restaurar una copia de seguridad anterior (antes de que apareciera el error) es una solución segura. Asegúrate de tener una copia reciente de archivos y base de datos.

Resumen final

El error 500 en PrestaShop con cPanel puede ser frustrante, pero siguiendo estos pasos podrás identificar y solucionar la causa en la mayoría de los casos. Recuerda:

Activa el modo debug para ver el error real.
Revisa y regenera el .htaccess.
Corrige permisos de archivos.
Aumenta la memoria PHP.
Desactiva módulos problemáticos.
Verifica la configuración de la base de datos.
Ajusta la versión de PHP.

Si después de todo esto sigues atascado, no dudes en pedir ayuda a tu hosting. Con un poco de paciencia, tu tienda volverá a funcionar.

[TIP FINAL] Siempre mantén una copia de seguridad actualizada de tu PrestaShop. Así, ante cualquier problema, podrás restaurar rápidamente sin perder ventas ni datos.