Cómo solucionar error 500 en PrestaShop desde cPanel

¡Hola! Soy el técnico de soporte amigable.

¿Has visto la temida pantalla blanca con el mensaje "Error 500 – Internal Server Error" en tu tienda PrestaShop? No te preocupes, es uno de los errores más comunes en el hosting y, por suerte, casi siempre tiene solución.

En esta guía extensa y paso a paso, te voy a enseñar a solucionar el error 500 en PrestaShop desde cPanel. Vamos a ir desde lo más sencillo hasta lo más técnico, siempre con un lenguaje claro y fácil de seguir. Al final, serás capaz de diagnosticar y arreglar este problema por ti mismo.

¿Qué es exactamente un error 500 en PrestaShop?

Antes de meter mano, entendamos qué está pasando. Un error 500 es un código de estado HTTP que significa "Error Interno del Servidor". En términos simples, es como si tu servidor (el ordenador que aloja tu web) estuviera teniendo un "mal día" y no pudiera procesar una petición, pero sin darte detalles específicos.

En PrestaShop, este error suele aparecer por varias razones:

Problemas de permisos de archivos: Los archivos y carpetas de tu tienda no tienen los permisos correctos para ser leídos o ejecutados.
Errores en el archivo .htaccess: Este archivo es como el "director de orquesta" de tu servidor web. Si está mal escrito, todo se detiene.
Fallo en un módulo o tema: Un módulo o tema recién instalado o actualizado puede estar causando un conflicto.
Límite de memoria de PHP excedido: Tu tienda necesita más memoria de la que el servidor le permite usar.
Versión de PHP incompatible: PrestaShop requiere una versión específica de PHP para funcionar correctamente.
Archivos corruptos o faltantes: Una actualización fallida o una subida incompleta pueden dañar archivos críticos.

Primeros pasos: Diagnóstico rápido desde cPanel

Vamos a entrar en acción. Lo primero es acceder a tu cPanel. Si no sabes cómo, contacta con tu proveedor de hosting. Una vez dentro, realizaremos unas comprobaciones básicas.

1. Activar los errores de PHP (la clave para entender el problema)

Por defecto, los errores de PHP están ocultos. Para verlos, necesitamos modificar un archivo temporalmente.

Abre el Administrador de Archivos de cPanel (File Manager).
Navega hasta la carpeta raíz de tu PrestaShop (normalmente public_html o una subcarpeta como tienda o prestashop).
Busca el archivo llamado config/defines.inc.php.
Haz clic derecho sobre él y selecciona Editar.
Busca la línea que dice:
```
define('_PS_MODE_DEV_', false);
```
Cámbiala por:
```
define('_PS_MODE_DEV_', true);
```
Guarda el archivo.

Ahora, recarga tu tienda. En lugar de la pantalla blanca, deberías ver un mensaje de error detallado en rojo. ¡Anota ese mensaje! Es la clave para saber exactamente qué está fallando (por ejemplo, "Fatal error: Allowed memory size of...", "Class not found...", etc.).

[TIP] Una vez solucionado el error, NO OLVIDES volver a poner _PS_MODE_DEV_ en false en el mismo archivo. Dejarlo en true en un sitio en producción es un riesgo de seguridad.

2. Revisar los logs de errores del servidor

Si no ves errores con el paso anterior, o si prefieres un método más directo, podemos consultar los logs del servidor.

En cPanel, busca la sección "Registros" o "Logs".
Haz clic en "Errores" o "Error Log".
Verás una lista de los errores más recientes. Busca los que tengan tu dominio o la hora en que ocurrió el error 500.

Los logs te darán pistas muy precisas. Por ejemplo, un error como [error] [client x.x.x.x] ModSecurity: Access denied... indicaría que el firewall está bloqueando algo.

Soluciones paso a paso para el error 500

Aquí tienes las soluciones más efectivas, ordenadas de la más simple a la más compleja.

Solución 1: Regenerar el archivo `.htaccess`

Este es el primer paso que debes probar, ya que es muy común que se corrompa.

Ve al Administrador de Archivos de cPanel.
Busca el archivo .htaccess en la raíz de tu instalación de PrestaShop.
Descarga una copia de seguridad de este archivo a tu ordenador (por si acaso).
Elimina el archivo .htaccess original de la carpeta.
Ahora, ve al Back Office de PrestaShop (si puedes acceder, aunque a veces el error también lo impide). Si no puedes, salta al paso 6.
- Ve a Configuración de la tienda > Parámetros generales > SEO y URLs.
- Haz clic en el botón "Guardar" (sin cambiar nada). Esto regenerará el archivo .htaccess.
Si no puedes acceder al Back Office, tendremos que forzar la regeneración desde la base de datos (es un poco más técnico, pero funciona).
- En cPanel, busca la sección "Bases de datos" y haz clic en "phpMyAdmin".
- Selecciona la base de datos de tu PrestaShop.
- Busca la tabla ps_configuration (el prefijo ps_ puede variar).
- Busca la fila con el nombre PS_HTACCESS_DISABLE y asegúrate de que su valor sea 0.
- Luego, busca la fila PS_REWRITING_SETTINGS y cámbiala a 1.
- Vuelve a tu tienda y recarga. A veces, esto fuerza la regeneración.

Solución 2: Aumentar el límite de memoria de PHP

Si el error decía algo sobre "Allowed memory size", esta es tu solución.

En cPanel, busca la sección "Software" o "Configuración de Software".
Haz clic en "Seleccionar versión de PHP" o "MultiPHP Manager".
Asegúrate de que tu dominio esté seleccionado.
Busca la opción "memory_limit" y cámbiala a un valor más alto, por ejemplo, 256M o 512M.
Haz clic en "Aplicar" o "Save".

[INFO] Algunos proveedores de hosting limitan esta opción. Si no puedes aumentarla a más de 128M, contacta con su soporte.

Solución 3: Restablecer permisos de archivos y carpetas

Los permisos incorrectos son una causa muy común del error 500.

Ve al Administrador de Archivos de cPanel.
Selecciona todos los archivos y carpetas de la raíz de tu PrestaShop (Ctrl+A).
Haz clic derecho y selecciona "Cambiar permisos".
En la ventana que aparece:
- Para carpetas: marca los permisos 755 (lectura, escritura y ejecución para el usuario; lectura y ejecución para el grupo y otros).
- Para archivos: marca los permisos 644 (lectura y escritura para el usuario; solo lectura para el grupo y otros).
Marca la casilla "Recursivo" (para que se aplique a todas las subcarpetas y archivos).
Haz clic en "Cambiar permisos".

También puedes hacerlo por línea de comandos si tienes acceso SSH, pero desde cPanel es más visual.

Solución 4: Deshabilitar temporalmente módulos y temas

Si el error apareció después de instalar o actualizar algo, es muy probable que el culpable sea un módulo o tema.

Accede a tu Base de Datos desde phpMyAdmin en cPanel.
Selecciona la base de datos de PrestaShop.
Busca la tabla ps_module (el prefijo puede variar).
Haz clic en la pestaña "SQL" y ejecuta la siguiente consulta para deshabilitar todos los módulos no nativos:
```
UPDATE `ps_module` SET `active` = 0 WHERE `active` = 1;
```
¡CUIDADO! Esto desactivará TODOS los módulos. Si tu tienda se arregla, sabrás que el problema es uno de ellos. Luego puedes ir reactivándolos uno por uno desde el Back Office (si puedes acceder).
Si el problema es el tema, busca la tabla ps_configuration y cambia el valor de PS_THEME_NAME a un tema por defecto como classic.

Solución 5: Verificar y cambiar la versión de PHP

PrestaShop necesita una versión de PHP específica. Las versiones muy antiguas o muy nuevas pueden causar errores.

En cPanel, ve a "Seleccionar versión de PHP" o "MultiPHP Manager".
Asegúrate de que tu dominio esté usando una versión compatible con tu versión de PrestaShop.
- Para PrestaShop 1.7 y 8.x: PHP 7.4, 8.0 o 8.1 (recomendado).
- Para PrestaShop 1.6: PHP 5.6, 7.0 o 7.1.
Selecciona la versión adecuada y haz clic en "Aplicar".

[WARNING] Cambiar de versión de PHP puede causar otros problemas si usas módulos o temas antiguos. Hazlo con cuidado y ten un backup.

Solución 6: Revisar el archivo `settings.inc.php`

Este archivo contiene la configuración de la conexión a la base de datos. Si está dañado, todo falla.

En el Administrador de Archivos, ve a la carpeta config/.
Busca el archivo settings.inc.php.
Ábrelo para editarlo.
Verifica que los datos de conexión (nombre de base de datos, usuario, contraseña y servidor) sean correctos. Si no estás seguro, puedes consultarlos en la sección "Bases de datos MySQL" de cPanel.
Si todo parece correcto, no toques nada. Si algo está mal, corrígelo y guarda.

Solución 7: Reinstalar archivos de PrestaShop (último recurso)

Si nada de lo anterior funciona, es posible que tengas archivos corruptos. La solución es reemplazarlos.

Descarga una copia limpia de tu misma versión de PrestaShop desde el sitio oficial.
Haz una copia de seguridad de tu tienda (archivos y base de datos). ¡Esto es crítico!
Elimina TODOS los archivos y carpetas de la raíz de tu instalación, EXCEPTO:
- La carpeta img/ (contiene tus imágenes de productos).
- La carpeta themes/ (si tienes un tema personalizado, guarda solo tu tema).
- La carpeta modules/ (si tienes módulos de pago, guárdalos).
- El archivo config/settings.inc.php (para mantener la conexión a la base de datos).
- El archivo .htaccess (lo regeneraremos después).
Sube los archivos de la copia limpia de PrestaShop a la raíz, sobrescribiendo todo.
Restaura los archivos que guardaste (img, themes, modules, settings.inc.php).
Regenera el .htaccess como vimos en la Solución 1.

Preguntas Frecuentes (FAQ)

P: ¿El error 500 puede deberse a un ataque informático?
R: Sí, es posible. Un ataque puede modificar archivos o el .htaccess. Si sospechas de un ataque, cambia todas tus contraseñas (cPanel, FTP, Base de Datos, Back Office) y revisa los archivos en busca de código malicioso.

P: ¿Y si uso Syspanel en lugar de cPanel?
R: Si tu hosting usa Syspanel (el nombre que le damos a HestiaCP), el proceso es similar. Accede a tu panel en tu-dominio.com:2106. Busca la sección de "Administrador de Archivos" o "Base de Datos" para aplicar las mismas soluciones. La lógica es idéntica.

P: ¿Cuánto tiempo puede durar la solución?
R: Desde unos minutos (si es solo el .htaccess) hasta una hora (si tienes que reinstalar archivos). La mayoría de los casos se resuelven en menos de 15 minutos.

P: ¿Debo contactar al soporte de mi hosting?
R: Si después de seguir todos estos pasos el error persiste, sí. Puede ser un problema a nivel de servidor (configuración de Apache, módulo de seguridad, etc.) que solo ellos pueden solucionar.

Conclusión

El error 500 en PrestaShop es frustrante, pero no es el fin del mundo. Como has visto, desde cPanel tienes todas las herramientas para diagnosticar y solucionar el problema. Recuerda empezar siempre por lo más sencillo (regenerar .htaccess y activar errores de PHP) y luego ir subiendo la complejidad.

Y lo más importante: siempre, siempre, siempre haz una copia de seguridad antes de hacer cambios drásticos. ¡Buena suerte y a vender!