Cómo arreglar el error 500 en PrestaShop (cPanel) - Guía rápida

¡Hola! Soy el técnico de soporte amigable de tu hosting. Hoy vamos a desentrañar uno de los errores más temidos (pero fáciles de solucionar) en las tiendas PrestaShop: el temido Error 500. Si ves una pantalla en blanco o un mensaje como "Error interno del servidor", no entres en pánico. Vamos a solucionarlo paso a paso, especialmente si tu tienda está alojada en un cPanel.

Este artículo está diseñado para que, incluso sin ser un experto técnico, puedas diagnosticar y solucionar error 500 PrestaShop tú mismo. Vamos a ello.

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

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 el contexto de PrestaShop, suele deberse a uno de estos motivos:

Archivos con permisos incorrectos (el servidor no puede leer o ejecutar ciertos archivos).
Un módulo o tema defectuoso que rompe la comunicación con el servidor.
Límites de memoria PHP excedidos (tu tienda requiere más recursos de los que tiene asignados).
Archivos corruptos después de una actualización o instalación fallida.
Problemas con el archivo .htaccess (configuración incorrecta de reglas de reescritura).

Como ves, no es un error de "fin del mundo", sino una señal de que algo necesita ajustes. Vamos a diagnosticarlo.

Primeros pasos: Activar el modo depuración de PrestaShop

Antes de tocar archivos del servidor, lo más inteligente es que PrestaShop nos muestre el error real. Por defecto, PrestaShop oculta los detalles del error 500. Vamos a cambiar eso.

### Paso 1: Accede a tu hosting (cPanel)

Inicia sesión en tu panel de control cPanel (normalmente accedes a través de tudominio.com/cpanel).
Busca la sección "Administrador de archivos" (File Manager) y ábrela.
Navega a la carpeta raíz de tu tienda (normalmente public_html o una subcarpeta como tienda).

### Paso 2: Edita el archivo `config/defines.inc.php`

Dentro de la carpeta raíz, abre la carpeta config.
Busca el archivo defines.inc.php y haz clic derecho > Editar (o "Edit").
Busca esta línea (normalmente cerca del final):
```
define('_PS_MODE_DEV_', false);
```
Cambia false por true:
```
define('_PS_MODE_DEV_', true);
```
Guarda los cambios (botón "Save Changes").

Ahora, cuando recargues tu tienda, en lugar de un error 500 genérico, verás un mensaje de error real con detalles como:

"Fatal error: Allowed memory size exhausted"
"Parse error: syntax error, unexpected..."
"Class 'X' not found"

Anota ese mensaje, porque nos dirá exactamente qué hacer. Si después de esto ves un error más claro, ¡genial! Si no, sigue con los pasos generales.

[WARNING] Una vez solucionado el problema, vuelve a poner define('_PS_MODE_DEV_', false); para no exponer información sensible a los visitantes.

Soluciones prácticas según el tipo de error

Dependiendo del mensaje que veas, aplica una de estas soluciones.

### Error: "Allowed memory size exhausted"

Esto significa que tu tienda necesita más memoria PHP. Es el error más común en tiendas con muchos productos o módulos pesados.

Solución en cPanel:

Ve a "Seleccionar versión de PHP" (o "MultiPHP Manager") en cPanel.
Busca la opción "Opciones de PHP" (o "Switch to PHP Options").
Localiza memory_limit y cámbialo a 256M (o 512M si tu hosting lo permite).
Haz clic en "Apply".

Si no encuentras esta opción, puedes hacerlo manualmente:

En el Administrador de archivos, busca el archivo .htaccess en la raíz de tu tienda.
Agrega esta línea al final:
```
php_value memory_limit 256M
```
Guarda y recarga la tienda.

[TIP] Si tu hosting tiene un límite máximo de memoria (ej. 128M), no podrás poner más de eso. En ese caso, contacta a soporte para aumentar el límite del plan.

### Error: "Class not found" o "Fatal error: require_once()"

Esto indica que un archivo de PrestaShop está dañado o falta. Generalmente ocurre después de una actualización fallida o al instalar un módulo incompatible.

Solución: Restaurar archivos de PrestaShop

Descarga una copia limpia de PrestaShop desde prestashop.com (misma versión que tienes instalada).
Descomprime el archivo en tu computadora.
Desde cPanel, sube y sobrescribe solo las carpetas admin, classes, controllers y override (no subas la carpeta img o themes para no perder personalizaciones).
Si el error persiste, restaura todo excepto config/settings.inc.php (que contiene tus datos de base de datos) y la carpeta themes (si tienes un tema personalizado).

### Error: "Parse error" o "syntax error"

Esto es típico de un módulo o tema con código mal escrito. El mensaje suele incluir el nombre del archivo y la línea del error.

Solución: Desactivar el módulo problemático

Si el error te muestra la ruta (ej. /modules/mimodulo/mimodulo.php), accede a tu servidor por FTP o cPanel.
Renombra la carpeta del módulo problemático (ej. de mimodulo a mimodulo_desactivado).
Recarga la tienda. Si el error desaparece, el módulo era el culpable. Puedes borrarlo o buscar una versión compatible.

Si no puedes acceder al panel de administración de PrestaShop (porque el error bloquea todo), haz lo mismo desde el Administrador de archivos de cPanel.

Solución general: Archivo `.htaccess` corrupto

A veces el error 500 es causado por un archivo .htaccess mal configurado (por ejemplo, después de activar reglas de redirección incorrectas).

Pasos para regenerarlo:

En cPanel, ve a la carpeta raíz de tu tienda.
Busca el archivo .htaccess. Si no lo ves, activa "Mostrar archivos ocultos" (Show Hidden Files) en la configuración del Administrador de archivos.
Renómbralo a .htaccess_backup (por si acaso).
Ahora, entra a tu panel de administración de PrestaShop (si puedes) y ve a Configuración > Tráfico y SEO > URL amigables.
Haz clic en "Guardar" sin cambiar nada. Esto regenerará el .htaccess automáticamente.

Si no puedes acceder al panel, crea un archivo .htaccess nuevo desde cero:

En el Administrador de archivos, crea un nuevo archivo llamado .htaccess.

Pega este contenido básico (ajusta la ruta si tu tienda está en una subcarpeta como /tienda):

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

Guarda y recarga la tienda.

Permisos de archivos: La causa silenciosa

Los permisos incorrectos son una causa frecuente de error 500. En cPanel:

En el Administrador de archivos, selecciona TODOS los archivos de la carpeta raíz (Ctrl+A).
Haz clic derecho > "Cambiar permisos".
Establece 755 para las carpetas y 644 para los archivos.
Marca la opción "Recursivo" (Recursive) para que se aplique a subcarpetas.
Haz clic en "Aceptar".

[INFO] No uses permisos 777 (escritura para todos) por seguridad. Solo temporalmente para pruebas.

¿Sigues con el error? Diagnóstico avanzado (logs del servidor)

Si nada de lo anterior funciona, hay que mirar los logs del servidor. Son como el "libro negro" de tu hosting.

### Cómo acceder a los logs de error en cPanel

En cPanel, busca la sección "Errores" (o "Error Log").
Haz clic en "Latest Visitor Errors" o "Error Log".
Busca líneas que contengan [error] y la fecha/hora actual.
Verás algo como:
```
[client 192.168.1.1] PHP Fatal error:  Uncaught Error: Call to undefined function...
```
Ese mensaje es la clave. Copia la línea y pégala en un bloc de notas.

Si no ves nada, activa el registro de errores PHP:

Ve a "Seleccionar versión de PHP" > "Opciones de PHP".
Busca display_errors y cámbialo a On.
Busca log_errors y cámbialo a On.
Guarda y recarga la tienda. Luego revisa el log de errores de nuevo.

FAQ: Preguntas frecuentes sobre el error 500 en PrestaShop

P: ¿El error 500 puede deberse a un plugin de caché?
R: Sí. Si usas un módulo de caché (como Page Cache), prueba a desactivarlo. A veces la caché guarda configuraciones corruptas. Borra la carpeta /cache/smarty/cache y /cache/smarty/compile desde cPanel (no borres las carpetas, solo su contenido).

P: Mi tienda está en un servidor con Syspanel (HestiaCP), ¿cómo accedo a los logs?
R: Si tu hosting usa Syspanel (HestiaCP), el acceso es por el puerto 2106 (ej. tudominio.com:2106). Dentro, busca la sección "Logs" o "Error Log" similar a cPanel. Los pasos para solucionar el error son los mismos.

P: ¿Qué hago si ni siquiera puedo entrar al panel de administración de PrestaShop?
R: Usa el Administrador de archivos de cPanel o FTP para desactivar módulos (renombrando sus carpetas) o regenerar el .htaccess como explicamos arriba. También puedes subir un archivo php.ini con memoria aumentada.

P: Después de restaurar archivos, el error sigue. ¿Qué más puedo hacer?
R: Prueba a restaurar la base de datos desde una copia de seguridad reciente. A veces el error viene de datos corruptos en tablas. Desde cPanel, usa "phpMyAdmin" para exportar e importar la base de datos.

P: ¿Debo contactar al soporte de mi hosting?
R: Si después de todos estos pasos el error persiste, sí. Pero antes, ten a mano los mensajes de error reales (del modo depuración o logs) para que el técnico pueda ayudarte rápido.

Resumen y checklist final

Para que no te pierdas, aquí tienes un resumen de los pasos en orden:

✅ Activa el modo depuración (defines.inc.php).
✅ Lee el mensaje de error real.
✅ Aumenta memory_limit si es necesario.
✅ Revisa y repara el .htaccess.
✅ Ajusta permisos de archivos a 755/644.
✅ Desactiva módulos problemáticos (renombrando carpetas).
✅ Restaura archivos de PrestaShop si están dañados.
✅ Revisa los logs del servidor (cPanel o Syspanel puerto 2106).

Recuerda, el error 500 es solo un grito de ayuda de tu servidor. Con paciencia y estos pasos, tu tienda volverá a funcionar en minutos. Si te quedas atascado, aquí estoy para ayudarte. ¡Buena suerte!