Error 500 en PrestaShop: Cómo solucionarlo fácilmente

¡Hola! Soy tu asistente de soporte técnico. Si estás leyendo esto, probablemente te has topado con la temida pantalla en blanco o el mensaje "Error 500 Internal Server Error" en tu tienda PrestaShop. No te preocupes, es un problema común y, en la mayoría de los casos, tiene solución.

En esta guía básica, vamos a desglosar paso a paso cómo solucionar error 500 PrestaShop. Vamos a ir desde lo más sencillo (que a veces es lo que falla) hasta lo un poco más técnico. El objetivo es que puedas dejar tu tienda funcionando de nuevo sin necesidad de ser un experto en Linux.

¿Preparado? ¡Vamos allá!

¿Qué es exactamente un Error 500 en PrestaShop?

Antes de ponernos manos a la obra, es importante entender qué significa. Un PrestaShop error interno (Error 500) es un mensaje genérico que indica que algo ha ido mal en el servidor, pero el servidor no puede dar más detalles. Es como si tu coche se parara y el tablero solo dijera "Fallo en el motor", sin decirte si es la batería, el combustible o una bujía.

Las causas más comunes suelen ser:

Un archivo de configuración corrupto (.htaccess o settings.inc.php).
Un módulo o tema que da problemas.
Límites de memoria del servidor PHP excedidos.
Permisos de archivos incorrectos.
Una actualización de PrestaShop que no se completó bien.

Vamos a atacar cada una de estas causas.

## Primeros Pasos: Diagnóstico Rápido (Sin Tocar Archivos)

Antes de editar nada, vamos a hacer un par de comprobaciones rápidas que pueden ahorrarte mucho tiempo.

### 1. Activa el Modo Debug de PrestaShop (Tu Mejor Amigo)

El Error 500 es mudo. Necesitamos que hable. Para ello, activaremos el modo depuración (debug) de PrestaShop. Esto mostrará el error real en la pantalla.

¿Cómo se hace?

Conéctate a tu servidor vía FTP (FileZilla, por ejemplo) o al panel de control de tu hosting (cPanel, Syspanel, etc.).
Busca la carpeta raíz de tu PrestaShop (normalmente public_html o www).
Localiza el archivo config/defines.inc.php.
Ábrelo con un editor de texto (Bloc de notas, Sublime Text, etc.).
Busca esta línea:
```
define('_PS_MODE_DEV_', false);
```
Cámbiala a:
```
define('_PS_MODE_DEV_', true);
```
Guarda el archivo y súbelo de nuevo al servidor (si lo editaste localmente).

Ahora, recarga tu tienda. En lugar de la pantalla en blanco, verás un mensaje de error más descriptivo, como "Fatal error: Allowed memory size exhausted..." o "Class not found...". Anota ese mensaje, nos será muy útil.

[TIP] Si no puedes acceder por FTP, muchos paneles de control (como Syspanel en el puerto 2106) tienen un "Administrador de Archivos" donde puedes editar archivos directamente.

### 2. El Clásico: Borrar la Cache de PrestaShop

A veces, el error 500 es simplemente un archivo de cache corrupto. Es el primer paso que debes probar.

Desde tu FTP o Administrador de Archivos, navega a la carpeta raíz de PrestaShop.
Busca la carpeta var/cache.
Dentro, verás subcarpetas como dev, prod, etc. Borra todo el contenido de la carpeta var/cache (pero no la carpeta en sí).
También puedes borrar la carpeta cache/smarty/cache y cache/smarty/compile si existen.

[WARNING] Si tu PrestaShop es muy antiguo (versión 1.6 o inferior), las carpetas de cache se llaman cache y tools/smarty/cache. Bórralas igualmente.

## Soluciones Paso a Paso para el Error 500

Si el diagnóstico rápido no lo resolvió, vamos a las soluciones más profundas.

### 1. Restaurar el Archivo .htaccess (El Gran Culpable)

El archivo .htaccess es el "semáforo" de tu tienda. Si se corrompe, todo se detiene. Es muy común que esto ocurra al instalar un módulo o cambiar la URL.

Pasos para restaurarlo:

Conéctate por FTP y ve a la raíz de PrestaShop.
Renombra el archivo .htaccess a .htaccess_old (esto lo desactiva).
Recarga tu tienda. Si el error 500 desaparece, ¡el problema era ese!
Ahora, debemos generar uno nuevo. Ve al panel de administración de PrestaShop (Back Office).
Ve a Configuración de la tienda > Tráfico y SEO.
En la pestaña SEO y URLs, abajo del todo, haz clic en Guardar (sin cambiar nada). Esto forzará a PrestaShop a regenerar el .htaccess automáticamente.

[INFO] Si no puedes acceder al Back Office, puedes crear un .htaccess básico. Crea un archivo de texto con solo esta línea y súbelo:
RewriteEngine On

### 2. Aumentar la Memoria PHP (Límite de Memoria)

Si el error que viste en el modo debug decía algo como "Allowed memory size of X bytes exhausted", necesitas darle más memoria a PHP.

¿Cómo se hace?

Opción A (Recomendada): Desde el Panel de Control.
- En cPanel: Busca la sección "Software" o "Seleccionar versión de PHP". Ahí podrás ajustar memory_limit a 256M o 512M.
- En Syspanel (puerto 2106): Ve a "Web" > "Ajustes PHP". Busca la opción memory_limit y cámbiala a 256M.
Opción B (Manual): Editando el php.ini.
- Localiza tu archivo php.ini (pregunta a tu hosting si no lo encuentras).
- Busca memory_limit y cámbialo a memory_limit = 256M.
Opción C (Solo PrestaShop): En el archivo config/defines.inc.php, justo después de la línea que editamos antes, añade:
```
ini_set('memory_limit', '256M');
```

### 3. Deshabilitar Módulos Conflictivos (A Ciegas)

Si no puedes acceder al Back Office, un módulo está bloqueando todo. Hay que deshabilitarlos manualmente.

Conéctate a tu base de datos (phpMyAdmin desde tu panel de control, o usando un cliente como MySQL Workbench).
Busca la tabla ps_module (el prefijo ps_ puede ser diferente, como prestashop_).
Dentro de esa tabla, verás todos los módulos instalados. Para deshabilitarlos todos (y luego ir activando uno a uno), ejecuta esta consulta SQL:
```
UPDATE ps_module SET active = 0 WHERE 1;
```
Si el error desaparece, el problema era un módulo. Ahora, desde el Back Office, ve activándolos de uno en uno hasta encontrar el culpable.

[WARNING] Si no te sientes cómodo con SQL, pide ayuda a tu hosting. Una mala consulta puede romper la base de datos.

### 4. Verificar los Permisos de Archivos y Carpetas

Los permisos incorrectos son otra causa frecuente de un PrestaShop error interno. PrestaShop necesita poder escribir en ciertas carpetas.

Los permisos correctos son:

Carpetas (directorios): 755
Archivos: 644

¿Cómo se hace?

Desde tu FTP: Selecciona toda la carpeta raíz, haz clic derecho > "Permisos de archivos" o "CHMOD". Marca las casillas correspondientes (dueño: lectura, escritura, ejecución; grupo: lectura, ejecución; público: lectura, ejecución). Aplica a todas las subcarpetas y archivos.

[TIP] Muchos paneles de control tienen una opción "Reparar permisos" o "Fix permissions" que lo hace automáticamente.

## ¿Sigues con el Error? Causas Avanzadas y FAQ

Si has llegado hasta aquí y el error persiste, vamos a por las causas menos comunes pero más complejas.

### 1. Problemas con la Versión de PHP

PrestaShop es muy sensible a la versión de PHP. Una versión muy nueva o muy antigua puede dar error 500.

Recomendaciones generales:

PrestaShop 1.7: PHP 7.1 a 8.1 (recomendado 7.4 o 8.0).
PrestaShop 1.6: PHP 5.6 a 7.1 (recomendado 5.6 o 7.0).
PrestaShop 1.5 o inferior: PHP 5.4 o 5.5.

Puedes cambiar la versión de PHP desde tu panel de control (cPanel, Syspanel, etc.). En Syspanel (puerto 2106), busca la opción "Versión PHP" en la sección "Web".

### 2. El Archivo settings.inc.php Corrupto

Este archivo contiene la configuración de la base de datos. Si se daña, PrestaShop no puede conectar.

Localiza el archivo config/settings.inc.php.
Haz una copia de seguridad (descárgalo).
Ábrelo y verifica que los datos de conexión (servidor, usuario, contraseña, nombre de la base de datos) sean correctos. A veces, un cambio de hosting o contraseña deja esto obsoleto.

### 3. Overrides de Terceros

Si has instalado módulos que "sobrescriben" (override) el núcleo de PrestaShop, pueden generar conflictos.

Solución temporal:

Ve a la carpeta override/classes y override/controllers.
Renombra las carpetas a override/classes_old y override/controllers_old.
Si el error desaparece, el problema es un override. Deberás identificar cuál es y contactar al desarrollador del módulo.

## FAQ: Preguntas Frecuentes

P: ¿El error 500 puede deberse a mi hosting?
R: Sí, es posible. Un servidor sobrecargado, un firewall mal configurado o un límite de recursos muy bajo pueden provocarlo. Contacta a tu proveedor de hosting y diles que tienes un error 500 en PrestaShop.

P: He borrado la cache y sigue igual. ¿Qué hago?
R: No te desesperes. Prueba los pasos en orden: 1) Modo debug, 2) Restaurar .htaccess, 3) Aumentar memoria PHP, 4) Deshabilitar módulos. El 90% de los casos se resuelven con estos pasos.

P: ¿Cómo accedo a Syspanel para cambiar la configuración de PHP?
R: Syspanel es el panel de control que mencionamos. Accede a tudominio.com:2106 (sustituye "tudominio.com" por tu dominio real). Una vez dentro, busca la sección "Web" o "Ajustes PHP".

P: No tengo acceso al Back Office ni por FTP, ¿qué hago?
R: Contacta a tu proveedor de hosting inmediatamente. Ellos tienen acceso de root al servidor y pueden restaurar un backup o arreglar el problema desde dentro.

P: ¿El error 500 puede ser un ataque de hackers?
R: Es menos común, pero posible. Si tu tienda ha sido atacada, es probable que hayan modificado archivos. Revisa si hay archivos extraños en la raíz (como shell.php o cmd.php) o si tu .htaccess tiene reglas de redirección sospechosas.

## Resumen y Consejo Final

Solucionar error 500 PrestaShop puede parecer un laberinto, pero con paciencia y siguiendo esta guía, lo resolverás. Recuerda el orden de batalla:

Activar modo debug para ver el error real.
Borrar la cache.
Restaurar el .htaccess.
Aumentar la memoria PHP.
Deshabilitar módulos (por SQL si es necesario).
Verificar permisos.
Revisar la versión de PHP y el settings.inc.php.

[INFO] Si después de todo esto el error continúa, no dudes en buscar ayuda profesional o contactar al soporte de tu hosting. A veces, el problema está en el servidor y no en tu tienda. ¡Buena suerte y que tus ventas vuelvan a funcionar!