Solucionar error 500 en PrestaShop con cPanel | Guía rápida

¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto, probablemente te has encontrado con la temida pantalla blanca o el mensaje "Error 500 – Internal Server Error" en tu tienda PrestaShop. No te preocupes, es uno de los errores más comunes y, con las herramientas adecuadas (como cPanel), podemos solucionarlo paso a paso. En esta guía completa, te explicaré cómo solucionar error 500 PrestaShop cPanel, incluso si no eres un experto técnico.

Vamos a empezar por lo básico: un error 500 significa que el servidor no puede procesar tu solicitud, pero no te da detalles específicos. La buena noticia es que con cPanel podemos depurar PrestaShop cPanel para encontrar la causa exacta. Sigue cada sección con calma y, si te pierdes, recuerda que siempre puedes contactar a tu proveedor de hosting.

¿Qué causa el error 500 en PrestaShop?

Antes de lanzarnos a solucionarlo, es útil entender las causas más frecuentes:

Archivos .htaccess corruptos: PrestaShop usa este archivo para reglas de redirección y seguridad. Si se daña, el servidor se bloquea.
Límites de memoria PHP excedidos: Si tu tienda tiene muchos módulos o tráfico, puede superar el límite de memoria permitido.
Módulos o temas incompatibles: Una actualización o instalación reciente puede generar conflictos.
Permisos de archivos incorrectos: Si los archivos tienen permisos demasiado restrictivos o abiertos, el servidor falla.
Errores en el archivo config/settings.inc.php: Datos de conexión a la base de datos incorrectos o dañados.
Problemas con PHP: Versión de PHP incompatible o extensiones faltantes.

Requisitos previos antes de empezar

Necesitarás acceso a:

cPanel: El panel de control de tu hosting (proporcionado por tu proveedor).
Gestor de archivos o FTP: Para modificar archivos directamente.
phpMyAdmin: Para revisar la base de datos si es necesario.
Paciencia: No te apresures, cada paso es importante.

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el acceso es por el puerto 2106. El proceso es similar, pero las rutas pueden variar ligeramente.

Paso 1: Habilita el modo debug de PrestaShop

Para depurar PrestaShop cPanel correctamente, necesitamos que el sistema muestre el error real en lugar de la pantalla blanca. Esto se hace editando el archivo config/defines.inc.php.

Instrucciones:

Accede a cPanel e ingresa al Administrador de archivos (File Manager).
Navega a la carpeta raíz de tu tienda (normalmente public_html o una subcarpeta como tienda).
Busca la carpeta config y dentro de ella el archivo defines.inc.php.
Haz clic derecho sobre el archivo y selecciona Editar (o Code Editor).

Busca la línea que dice:

define('_PS_MODE_DEV_', false);

Cámbiala a:

define('_PS_MODE_DEV_', true);

Guarda los cambios y cierra el editor.

Ahora, al recargar tu tienda, verás un mensaje de error detallado con el número de línea y el archivo problemático. ¡Eso es oro puro! Anota ese error, porque te guiará en los siguientes pasos.

[WARNING] No olvides volver a poner false cuando termines de depurar, o tu tienda mostrará información sensible a los visitantes.

Paso 2: Revisa el archivo .htaccess

El archivo .htaccess es uno de los principales sospechosos. Si está corrupto, puedes regenerarlo o reemplazarlo.

Cómo regenerar el .htaccess:

En el Administrador de archivos, localiza el archivo .htaccess en la raíz de tu tienda.
Renómbralo a algo como .htaccess_backup (por si acaso).
Ve al panel de administración de PrestaShop (si puedes acceder) y navega a Configuración > Rendimiento.
Haz clic en Guardar sin cambiar nada. Esto regenerará el archivo automáticamente.

Si no puedes acceder al panel de administración, puedes crear un .htaccess básico temporal:

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

Pégalo en un archivo nuevo llamado .htaccess y súbelo a la raíz.

[TIP] Si el error persiste, prueba con un .htaccess vacío (solo el contenido mínimo) para descartar reglas conflictivas.

Paso 3: Aumenta los límites de memoria PHP

El error 500 suele aparecer cuando PHP se queda sin memoria. En cPanel, puedes ajustar esto fácilmente.

Opción A: Desde el selector de PHP (recomendado)

En cPanel, busca Seleccionar versión de PHP (o MultiPHP Manager).
Haz clic en Opciones o Switch to PHP Options.
Busca la variable memory_limit y cámbiala a un valor como 256M o 512M.
También ajusta max_execution_time a 120 y max_input_vars a 5000.
Guarda los cambios.

Opción B: Editando el archivo php.ini

Si no encuentras la opción anterior, puedes crear o modificar un archivo php.ini en la raíz de tu tienda:

memory_limit = 256M
max_execution_time = 120
max_input_vars = 5000

O si tu hosting usa Syspanel, accede por el puerto 2106 y busca la sección de configuración PHP.

[WARNING] No subas demasiado el límite de memoria (más de 512M) sin consultar con tu hosting, podrías afectar el rendimiento del servidor.

Paso 4: Verifica los permisos de archivos y carpetas

Los permisos incorrectos son otra causa común. En PrestaShop, los archivos deben tener permisos 644 y las carpetas 755.

Cómo corregirlos desde cPanel:

En el Administrador de archivos, selecciona toda la carpeta de tu tienda.
Haz clic en Permisos (o Change Permissions).
Marca las siguientes opciones:
- Archivos: 644 (lectura y escritura para el propietario, solo lectura para grupo y público).
- Carpetas: 755 (lectura, escritura y ejecución para el propietario; lectura y ejecución para grupo y público).
Activa la opción Aplicar a subdirectorios y archivos.
Haz clic en Cambiar.

[INFO] Si usas FTP, puedes hacerlo con un cliente como FileZilla: selecciona todo, clic derecho y elige "Atributos de archivo".

Paso 5: Revisa el archivo settings.inc.php

Este archivo contiene la conexión a la base de datos. Si está dañado, el error 500 es inevitable.

Pasos:

En config/settings.inc.php, busca las siguientes líneas:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_base_de_datos');
define('_DB_USER_', 'tu_usuario');
define('_DB_PASSWD_', 'tu_contraseña');

Verifica que los datos sean correctos (puedes consultarlos en cPanel > Bases de datos MySQL).
Si todo está bien, pero el error persiste, prueba a renombrar temporalmente este archivo (por ejemplo, a settings.inc.php.bak) y luego restáuralo. A veces, forzar su recreación ayuda.

[WARNING] Nunca compartas este archivo con nadie, ya que contiene credenciales de acceso a tu base de datos.

Paso 6: Desactiva módulos y temas desde la base de datos

Si no puedes acceder al panel de administración, desactivar módulos problemáticos desde phpMyAdmin es una solución rápida.

Instrucciones:

En cPanel, busca phpMyAdmin y selecciona la base de datos de tu tienda.
Busca la tabla ps_module (el prefijo puede variar, por ejemplo, ps_).
Haz clic en Examinar (Browse).
Identifica módulos sospechosos (por ejemplo, los que instalaste recientemente).
Marca la casilla junto al módulo y selecciona Editar (Edit).
Cambia el campo active de 1 a 0.
Guarda y repite si es necesario.

Para desactivar el tema, busca la tabla ps_configuration y localiza la variable PS_THEME_NAME. Cámbiala por el nombre de un tema predeterminado (como classic).

[TIP] Si no estás seguro de qué módulo causa el error, desactívalos todos y luego actívalos uno por uno para identificar el culpable.

Paso 7: Revisa los logs del servidor

Los logs del servidor son tu mejor amigo para solucionar error 500 PrestaShop cPanel. Te dan pistas precisas.

Cómo acceder:

En cPanel, busca Registros de errores (Error Log) o Apache Logs.
Busca la sección de Latest Visitors o Error Log.
Filtra por la fecha y hora del error.
Busca líneas que contengan PHP Fatal error o mod_fcgid. Anota el archivo y la línea.

[INFO] Si tu hosting usa Syspanel, los logs están en la sección "Logs" del panel (puerto 2106).

Paso 8: Prueba con una versión de PHP diferente

PrestaShop es sensible a la versión de PHP. Por ejemplo, PrestaShop 1.6 funciona mejor con PHP 5.6 o 7.0, mientras que 1.7 y 8.x requieren PHP 7.1 o superior.

Cambiar la versión de PHP en cPanel:

Ve a Seleccionar versión de PHP.
Elige una versión compatible con tu PrestaShop (consulta la documentación oficial).
Guarda y prueba de nuevo.

Paso 9: Limpia la caché de PrestaShop

A veces, la caché corrupta provoca errores 500. Puedes limpiarla manualmente:

Desde el Administrador de archivos, elimina el contenido de las carpetas:
- /cache/smarty/compile
- /cache/smarty/cache
- /cache/class_index.php (si existe)
También puedes renombrar la carpeta /cache a /cache_old y crear una nueva carpeta vacía llamada cache.
Si accedes al panel de administración, ve a Configuración > Rendimiento y haz clic en Limpiar caché.

Preguntas frecuentes (FAQ)

¿Qué hago si no tengo acceso a cPanel?

Contacta a tu proveedor de hosting. Ellos pueden habilitar el modo debug o revisar los logs por ti. Si usas Syspanel, recuerda que el acceso es por el puerto 2106.

¿El error 500 puede deberse a un plugin de SEO?

Sí, especialmente si el plugin modifica el .htaccess o añade reglas de redirección. Desactívalo temporalmente para probar.

¿Cómo evito este error en el futuro?

Mantén PrestaShop, módulos y temas actualizados.
Realiza copias de seguridad frecuentes.
Usa un hosting que ofrezca suficiente memoria PHP.
No instales módulos de fuentes no confiables.

¿Puedo restaurar una copia de seguridad si todo falla?

Sí, desde cPanel puedes usar JetBackup o Backup para restaurar archivos y base de datos. Asegúrate de tener una copia reciente.

Conclusión

El error 500 PrestaShop cPanel puede ser frustrante, pero con estos pasos metódicos, podrás solucionar error 500 PrestaShop sin necesidad de ser un experto. Recuerda habilitar el modo debug para obtener pistas, revisar el .htaccess, ajustar la memoria PHP y verificar permisos. Si el error persiste, los logs del servidor y la desactivación de módulos desde phpMyAdmin son tus aliados.

[TIP] Siempre trabaja con calma y, si te sientes inseguro, pide ayuda a tu hosting. ¡No estás solo en esto!

Espero que esta guía te haya sido de gran ayuda. Si tienes más dudas, no dudes en consultarme. ¡Buena suerte con tu tienda PrestaShop!