Solucionar error 500 en PrestaShop cPanel | Métodos efectivos

Si has llegado hasta aquí buscando cómo solucionar el error 500 en tu tienda PrestaShop alojada en cPanel, has dado en el clavo. Este error es uno de los más temidos, pero también uno de los más fáciles de resolver si sigues los pasos adecuados. En esta guía, te explicaré de forma clara y paso a paso cómo identificar la causa y solucionar el error 500 PrestaShop cPanel, incluso si no eres un experto técnico.

El error 500 (Internal Server Error) es un mensaje genérico que indica que algo salió mal en el servidor, pero no especifica qué. En PrestaShop, suele deberse a problemas de permisos de archivos, archivos corruptos, módulos incompatibles o configuraciones incorrectas en el servidor. No te preocupes: con paciencia y siguiendo esta guía, podrás tener tu tienda funcionando de nuevo.

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

El error 500 es un código de estado HTTP que significa "Error interno del servidor". En el contexto de PrestaShop y cPanel, puede aparecer por varias razones:

Permisos de archivos incorrectos: PrestaShop necesita permisos específicos para leer y escribir archivos.
Archivos .htaccess corruptos: Este archivo controla las reglas de reescritura de URL y, si está mal configurado, causa el error.
Módulos o temas incompatibles: Una actualización o instalación reciente puede generar conflictos.
Problemas de memoria PHP: Límites de memoria insuficientes para ejecutar scripts.
Archivos de caché corruptos: La caché de PrestaShop puede dañarse y provocar errores.
Errores en el archivo de configuración (settings.inc.php): Datos incorrectos de la base de datos.

[INFO] Antes de empezar, asegúrate de tener acceso a cPanel y a tu panel de administración de PrestaShop. Si no puedes acceder a ninguno, necesitarás usar FTP o el administrador de archivos de cPanel.

Paso 1: Habilitar la visualización de errores en PrestaShop

Lo primero que debes hacer es obtener más información sobre el error. Por defecto, PrestaShop muestra un mensaje genérico, pero podemos activar el modo de depuración para ver el error real.

Accede a tu servidor vía FTP o cPanel File Manager

Inicia sesión en cPanel.
Ve a Archivos > Administrador de archivos.
Navega hasta la carpeta raíz de tu tienda (normalmente public_html o una subcarpeta).
Busca el archivo config/defines.inc.php.

Edita el archivo defines.inc.php

Haz clic derecho sobre el archivo y selecciona Editar.
Busca la línea que dice: define('_PS_MODE_DEV_', false);
Cámbiala por: 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 la causa exacta. Anótalo, ya que te ayudará a identificar el problema.

[WARNING] No olvides volver a poner false cuando termines de solucionar el error, ya que tener el modo desarrollo activado en producción puede exponer información sensible.

Paso 2: Verificar y corregir permisos de archivos

Los permisos incorrectos son una de las causas más comunes del error 500 PrestaShop cPanel. PrestaShop necesita permisos específicos para funcionar correctamente.

Permisos recomendados

Carpetas: 755 (rwxr-xr-x)
Archivos: 644 (rw-r--r--)

Cómo corregir permisos en cPanel

En el Administrador de archivos, selecciona todos los archivos y carpetas de tu tienda.
Haz clic en Permisos en la barra superior.
Para las carpetas: marca 755.
Para los archivos: marca 644.
Aplica los cambios.

Si usas FTP, puedes hacerlo desde tu cliente FTP seleccionando todo y cambiando los permisos de forma masiva.

[TIP] Si tienes problemas, también puedes ejecutar un script de reparación de permisos. Algunos hosting ofrecen esta opción en cPanel.

Paso 3: Revisar y regenerar el archivo .htaccess

El archivo .htaccess de PrestaShop puede corromperse, especialmente después de una actualización o cambios en las URL amigables. Esto provoca el error 500.

Elimina el archivo .htaccess antiguo

En el Administrador de archivos, busca el archivo .htaccess en la raíz de tu tienda.
Si no lo ves, activa la opción Mostrar archivos ocultos.
Haz clic derecho y selecciona Eliminar (no te preocupes, lo regeneraremos).

Regenera el .htaccess desde el panel de administración

Accede a tu panel de administración de PrestaShop (si puedes).
Ve a Configuración avanzada > Rendimiento.
Haz clic en Guardar sin cambiar nada, esto regenerará el archivo.
Si no puedes acceder al panel, puedes crear un archivo .htaccess básico manualmente:

# START PrestaShop
<IfModule mod_rewrite.c>
RewriteEngine on
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 de tu tienda.

[INFO] Si después de esto el error persiste, el problema puede estar en los módulos o en la base de datos.

Paso 4: Deshabilitar módulos y temas problemáticos

Los módulos o temas incompatibles son otra causa frecuente. Si instalaste algo recientemente, puede estar generando el error.

Deshabilitar módulos desde la base de datos

Si no puedes acceder al panel de administración, usa phpMyAdmin en cPanel:

Ve a Bases de datos > phpMyAdmin.
Selecciona la base de datos de tu tienda.
Busca la tabla ps_module (el prefijo puede variar).
Haz clic en Examinar y luego en SQL.
Ejecuta la siguiente consulta para deshabilitar todos los módulos no esenciales:

UPDATE ps_module SET active = 0 WHERE id_module > 1;

Esto desactivará todos los módulos excepto los esenciales. Luego, desde el panel de administración, puedes ir activándolos uno por uno para identificar el culpable.

Cambiar al tema predeterminado

En la base de datos, busca la tabla ps_configuration.
Ejecuta: SELECT * FROM ps_configuration WHERE name = 'PS_THEME';
Cambia el valor a classic (o el nombre del tema predeterminado de tu versión de PrestaShop).

Paso 5: Aumentar el límite de memoria PHP

PrestaShop puede necesitar más memoria de la que tu servidor tiene configurada por defecto. Esto provoca un error 500.

Cómo aumentar la memoria en cPanel

Ve a Software > Seleccionar versión de PHP (o MultiPHP Manager).
Haz clic en Opciones o Configuración.
Busca memory_limit y cámbialo a 256M o 512M.
Guarda los cambios.

Si no tienes acceso a esta opción, puedes crear un archivo php.ini en la raíz de tu tienda con:

memory_limit = 256M
max_execution_time = 120
max_input_time = 60

[WARNING] No todos los hosting permiten modificar estos valores. Si no encuentras la opción, contacta con tu proveedor.

Paso 6: Limpiar la caché de PrestaShop

La caché corrupta puede causar errores. Puedes limpiarla manualmente.

Limpiar caché manualmente

En el Administrador de archivos, navega a la carpeta var/cache (en PrestaShop 1.7) o cache (en versiones anteriores).
Elimina todos los archivos y carpetas dentro (no la carpeta en sí).
También puedes eliminar el contenido de var/cache/prod y var/cache/dev.

[TIP] Si usas PrestaShop 1.6, la carpeta de caché está en cache/smarty/cache y cache/smarty/compile. Elimina todo su contenido.

Paso 7: Verificar el archivo settings.inc.php

Este archivo contiene la configuración de la base de datos. Si está dañado o tiene datos incorrectos, el error 500 es inevitable.

Abre el archivo config/settings.inc.php (o app/config/parameters.php en PrestaShop 1.7).
Verifica que los datos de la base de datos (nombre, usuario, contraseña, servidor) sean correctos.
Si tienes dudas, puedes compararlos con los datos de cPanel > Bases de datos MySQL.

[INFO] Si el archivo está vacío o corrupto, puedes restaurarlo desde una copia de seguridad o regenerarlo manualmente.

Soluciones adicionales para el error 500 en PrestaShop

Si después de todos estos pasos el error persiste, prueba lo siguiente:

Verifica los logs del servidor: En cPanel, ve a Métricas > Errores para ver el log de errores de Apache. Busca líneas que contengan "PrestaShop" o "PHP Fatal error".
Reinstala PrestaShop desde cero: Como último recurso, puedes hacer una copia de seguridad de tu base de datos y archivos, y luego reinstalar la última versión de PrestaShop.
Contacta con tu hosting: A veces el problema es del servidor (por ejemplo, límites de recursos o configuraciones de PHP). Tu proveedor puede ayudarte.

[WARNING] Si usas Syspanel (anteriormente HestiaCP), el acceso es por el puerto 2106. Los pasos son similares, pero la interfaz cambia. Busca "Syspanel" en lugar de cPanel.

Preguntas frecuentes (FAQ) sobre el error 500 en PrestaShop

¿Qué significa exactamente el error 500 en PrestaShop?
Es un error interno del servidor que impide que la tienda cargue. No da detalles, por eso hay que activar el modo depuración.

¿Por qué aparece el error 500 después de actualizar PrestaShop?
Las actualizaciones pueden dejar archivos incompatibles, .htaccess corrupto o módulos desactualizados. Sigue los pasos 3 y 4 de esta guía.

¿Puedo solucionar el error 500 sin acceso al panel de administración?
Sí, usando FTP, cPanel File Manager o phpMyAdmin. Todos los pasos que te he dado se pueden hacer sin entrar al panel.

¿El error 500 puede deberse a un problema de hosting?
Sí, especialmente si el servidor tiene límites de recursos muy bajos o configuraciones de PHP restrictivas. Contacta a tu proveedor si nada funciona.

¿Cómo evitar que vuelva a ocurrir?
Mantén PrestaShop actualizado, haz copias de seguridad periódicas, evita instalar módulos de fuentes no confiables y revisa los permisos de archivos regularmente.

Conclusión

El error 500 PrestaShop cPanel puede parecer aterrador, pero con esta guía tienes todas las herramientas para solucionarlo. Recuerda siempre empezar por activar el modo depuración para obtener más información, luego revisa permisos, .htaccess, módulos y memoria PHP. Si todo falla, los logs del servidor serán tu mejor aliado.

No olvides que, si usas Syspanel (puerto 2106), los pasos son análogos pero la interfaz puede variar. En cualquier caso, la lógica es la misma: identificar la causa raíz y corregirla.

Espero que este artículo te haya sido de ayuda. ¡Tu tienda PrestaShop estará funcionando en poco tiempo!