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

¡Hola! Soy tu técnico de soporte amigable. ¿Te has encontrado con la temida pantalla en blanco o el mensaje "Error 500 Internal Server Error" en tu tienda PrestaShop? No te preocupes, es un problema muy común, pero también muy solucionable. En esta guía extensa y detallada, te explicaré paso a paso cómo resolver el error 500 en PrestaShop desde cPanel, para que puedas volver a vender en pocos minutos.

Vamos a desglosar este error interno del servidor en causas, diagnósticos y soluciones prácticas. Lo haremos de forma didáctica y con un lenguaje sencillo, para que incluso si no eres un experto técnico, puedas seguir cada instrucción.

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

El error 500, o error interno del servidor, es un mensaje genérico que indica que algo salió mal en el servidor web, pero no especifica exactamente qué. En el contexto de PrestaShop, suele deberse a:

Problemas de permisos de archivos y carpetas (los más comunes).
Errores en el archivo .htaccess (por ejemplo, después de una actualización o cambio de URL).
Módulos o temas defectuosos (incompatibles o mal instalados).
Límites de memoria PHP excedidos (por scripts pesados).
Errores en la configuración de PHP (versión incorrecta o funciones deshabilitadas).
Base de datos corrupta (menos frecuente, pero posible).

[INFO] El error 500 no siempre muestra detalles. Para ver la causa real, debemos activar la visualización de errores de PHP. Lo haremos más adelante.

Requisitos previos: Acceso a cPanel

Para solucionar error 500 PrestaShop necesitas acceder a tu panel de control de hosting. cPanel es el más común. Si tu hosting usa Syspanel (antes conocido como HestiaCP), el acceso es por el puerto 2106 (ejemplo: https://tudominio.com:2106). El resto de pasos son prácticamente iguales.

Paso 1: Activar la visualización de errores de PHP

El primer paso para solucionar error 500 PrestaShop es saber qué está fallando exactamente. Para ello, activaremos la visualización de errores de PHP.

Método A: Temporalmente desde cPanel (Recomendado)

Ingresa a cPanel y busca la sección "Seleccionar versión de PHP" o "MultiPHP Manager".
Haz clic en "Opciones" o "Switch to PHP Options".
Localiza las siguientes opciones y cámbialas:
- display_errors: On
- error_reporting: E_ALL
Guarda los cambios.

Método B: Añadiendo código en el archivo config/defines.inc.php

Si no encuentras las opciones en cPanel, edita el archivo config/defines.inc.php de tu PrestaShop (por FTP o File Manager de cPanel):

Abre el archivo y busca la línea: define('_PS_MODE_DEV_', false);
Cámbiala a: define('_PS_MODE_DEV_', true);
Guarda el archivo.

[WARNING] No dejes el modo desarrollo activado en producción. Desactívalo (false) una vez resuelto el error.

Ahora, al recargar tu tienda, en lugar del error 500 verás un mensaje descriptivo del tipo: Fatal error: Allowed memory size of ... bytes exhausted o Parse error: syntax error, unexpected.... ¡Esa es la pista que necesitamos!

Paso 2: Soluciones según el mensaje de error

Una vez que tenemos el mensaje real, aplicamos la solución específica.

Caso A: Error de memoria (Allowed memory size exhausted)

Solución: Aumentar el límite de memoria PHP.
Desde cPanel: Ve a "Seleccionar versión de PHP" → "Opciones" y busca memory_limit. Auméntalo a 256M o 512M.
Desde .htaccess: Si no tienes acceso a cPanel, añade esta línea al archivo .htaccess (en la raíz de PrestaShop):
```
php_value memory_limit 256M
```
Desde el archivo php.ini: Si tu hosting lo permite, crea o edita un archivo php.ini en la raíz con:
```
memory_limit = 256M
```

Caso B: Error en el archivo .htaccess

Solución: Regenerar el archivo .htaccess de PrestaShop.
Pasos:
1. Conéctate por FTP o File Manager y localiza el archivo .htaccess en la raíz de tu tienda.
2. Renómbralo a .htaccess_old (como respaldo).
3. Ve al panel de administración de PrestaShop (si puedes acceder) a Configuración → Parámetros generales → SEO y URLs.
4. Haz clic en "Guardar" sin cambiar nada. Esto regenerará el archivo.
5. Si no puedes acceder al admin, crea un archivo .htaccess vacío y luego desde la sección de Módulos → Administrador de módulos desactiva y reactiva el módulo "SEO de PrestaShop" (si lo tienes).

Caso C: Error por módulo o tema defectuoso

Solución: Deshabilitar módulos o cambiar el tema desde la base de datos o FTP.
Desde FTP (si no accedes al admin):
1. Ve a la carpeta /modules/ y renombra la carpeta del módulo sospechoso (ej: mimodulo a mimodulo_desactivado).
2. Si el error era por ese módulo, la tienda cargará.
Desde phpMyAdmin (base de datos):
1. Accede a phpMyAdmin desde cPanel.
2. Selecciona la base de datos de PrestaShop.
3. Busca la tabla ps_module (el prefijo ps_ puede variar).
4. Localiza el módulo problemático y cambia su estado active de 1 a 0.
Para cambiar el tema: Renombra la carpeta del tema activo en /themes/ (ej: tema_activo a tema_activo_old). PrestaShop usará el tema por defecto (Classic).

Caso D: Error de permisos de archivos

Solución: Establecer permisos correctos.
Desde cPanel (File Manager):
1. Selecciona la carpeta raíz de tu tienda.
2. Haz clic derecho → "Cambiar permisos".
3. Establece 755 para carpetas y 644 para archivos.
4. Marca la opción "Recursivo" para aplicar a todas las subcarpetas.
Desde FTP: Usa el cliente FTP (FileZilla) y ajusta los permisos de forma similar.

Caso E: Error de versión de PHP

Solución: Cambiar a una versión compatible de PHP.
Desde cPanel: En "Seleccionar versión de PHP", elige una versión 7.4 o 8.0 (PrestaShop 1.7 funciona bien con 7.4; versiones más nuevas pueden requerir PHP 8.1+). Guarda.

Paso 3: Solución genérica si no ves ningún mensaje de error

Si tras activar el modo desarrollo aún ves el error 500 (en blanco), puede ser un problema más profundo. Prueba estas soluciones universales:

1. Limpiar la caché de PrestaShop

Desde el admin (si puedes): Ve a Configuración → Rendimiento → Limpiar caché.
Desde FTP: Elimina el contenido de la carpeta /cache/ (no la carpeta en sí, solo los archivos internos). También borra la carpeta /var/cache/ si existe.

2. Aumentar el tiempo de ejecución (max_execution_time)

En cPanel → PHP Options, busca max_execution_time y ponlo a 120 o 300.

3. Desactivar temporalmente el SSL (si es reciente)

Si cambiaste a HTTPS recientemente, puede haber conflictos. Edita el archivo config/settings.inc.php y busca:
```
define('_PS_SSL_ENABLED_', '1');
```
Cámbialo a '0'. Recuerda revertirlo después.

Preguntas Frecuentes (FAQ) sobre el error 500 en PrestaShop

¿El error 500 puede deberse a una actualización de PrestaShop?

Sí, es muy común. Las actualizaciones pueden romper módulos, temas o el archivo .htaccess. Siempre haz una copia de seguridad antes de actualizar.

¿Cómo sé si es un problema del hosting o de mi tienda?

Si el error aparece solo en PrestaShop y no en otras webs de tu mismo hosting, es problema de la tienda. Si afecta a todo el sitio (incluyendo páginas estáticas), contacta a tu proveedor de hosting.

¿Puedo perder datos si modifico archivos?

Si solo editas archivos de configuración (.htaccess, defines.inc.php) o renombras carpetas de módulos, no pierdes datos. Siempre haz un respaldo antes de modificar la base de datos.

¿Qué hago si nada de esto funciona?

Activa el modo de depuración de PrestaShop (más avanzado) o revisa los logs del servidor en cPanel (sección "Registros de errores"). Si el error persiste, contacta a tu hosting con el mensaje exacto del error.

Consejos finales para evitar futuros errores 500

Mantén todo actualizado: PrestaShop, módulos, temas y PHP.
Haz copias de seguridad periódicas (archivos y base de datos).
Prueba los módulos en un entorno de desarrollo antes de instalarlos en producción.
No instales módulos de fuentes no confiables.
Configura un límite de memoria PHP adecuado (256MB es un buen estándar).

[TIP] Si usas Syspanel (puerto 2106), los pasos son idénticos a cPanel. Busca "PHP Settings" o "Server Config" para ajustar las opciones de PHP.

Espero que esta guía te haya sido de gran ayuda. Recuerda que el error 500 PrestaShop cPanel es frustrante, pero con paciencia y estos pasos, lo resolverás. Si te quedas atascado, no dudes en buscar ayuda en foros especializados o contactar a tu soporte técnico. ¡Buena suerte y a vender mucho!