Arreglar error 500 en PrestaShop (cPanel, Plesk, DirectAdmin)

¡Hola! Si has llegado hasta aquí, probablemente te has encontrado con la temida pantalla blanca o el mensaje de error 500 prestashop. No te preocupes, es uno de los problemas más comunes en tiendas online y, en la gran mayoría de los casos, tiene solución sin necesidad de ser un experto informático.

En esta guía completa, vamos a desglosar qué significa exactamente este error, cuáles son las causas más frecuentes y, lo más importante, te daremos un paso a paso claro y sencillo para solucionar error 500 en tu tienda. Vamos a ello.

¿Qué es exactamente el "Error 500" en PrestaShop?

Antes de ponernos manos a la obra, es fundamental entender qué está pasando. El prestashop internal server error (Error Interno del Servidor) es un mensaje genérico que lanza el servidor cuando algo ha salido mal en el código de tu web, pero el propio servidor no puede especificar exactamente qué es.

Piensa en ello como un "cajón desastre": el servidor sabe que hay un problema, pero no te dice si es un calcetín, una llave o un papel. Por eso, el error puede aparecer en diferentes situaciones:

Al intentar acceder a la tienda como cliente.
Al entrar al panel de administración (back-office).
Al intentar guardar un producto o modificar un módulo.
Al realizar una actualización de PrestaShop.

La buena noticia es que, aunque el mensaje sea genérico, las causas suelen ser bastante comunes y repetitivas. Vamos a verlas.

Causas más habituales del Error 500 en PrestaShop

Para arreglar error 500 prestashop, primero debemos ser detectives y localizar al culpable. Estas son las razones más típicas que provocan este fallo:

1. Archivos con permisos incorrectos (CHMOD)

Imagina que tu servidor es un edificio con puertas de seguridad. Cada archivo de tu PrestaShop tiene una "cerradura" (permisos) que indica quién puede leer, escribir o ejecutar. Si estos permisos están mal configurados, el servidor no puede acceder a los archivos y lanza el error.

Síntoma: El error aparece de repente, a menudo después de que un técnico o un plugin haya tocado algo.
Solución: Restablecer los permisos a los valores estándar (normalmente 644 para archivos y 755 para carpetas).

2. Archivo `.htaccess` corrupto o dañado

El archivo .htaccess es como el "director de tráfico" de tu servidor (Apache). Regula las redirecciones, las URLs amigables y la seguridad. Si este archivo se corrompe (por ejemplo, durante una actualización o una modificación manual), todo el tráfico se bloquea y aparece el error.

Síntoma: El error aparece justo después de activar las "URLs amigables" o de instalar un módulo de SEO.
Solución: Regenerar o eliminar temporalmente este archivo para que PrestaShop cree uno nuevo.

3. Conflicto con un módulo o tema (plantilla)

Esta es una de las causas más frecuentes. Un módulo instalado recientemente puede ser incompatible con tu versión de PrestaShop o con otro módulo. Lo mismo ocurre con el tema (la plantilla visual). Un pequeño error de código en el tema puede tumbar toda la tienda.

Síntoma: El error comienza justo después de instalar, actualizar o activar un módulo o un tema nuevo.
Solución: Desactivar el módulo o tema conflictivo. Si no puedes acceder al panel, tendrás que hacerlo manualmente desde el servidor.

4. Límite de memoria PHP (Memory Limit) agotado

PrestaShop es una plataforma que consume muchos recursos, sobre todo si tienes muchos módulos activos o una gran base de datos de productos. Si el límite de memoria PHP es demasiado bajo, el servidor se queda sin recursos y "muere" con un error 500.

Síntoma: El error aparece en páginas que cargan muchos datos (listados de productos, informes, etc.) o en momentos de mucho tráfico.
Solución: Aumentar el valor de memory_limit en el archivo de configuración de PHP.

5. Archivos de configuración corruptos (parameters.php)

PrestaShop guarda toda la configuración de la base de datos y los parámetros del sitio en un archivo llamado parameters.php. Si este archivo se daña o se vacía (a menudo por una instalación o actualización fallida), la tienda no puede conectarse a su base de datos y falla estrepitosamente.

Síntoma: El error aparece tras una actualización de PrestaShop o al mover la web de servidor.
Solución: Restaurar una copia de seguridad de este archivo o reconfigurarlo manualmente.

Cómo solucionar el error 500 en PrestaShop paso a paso

Ahora vamos a la acción. Te recomiendo seguir estos pasos en orden, de menor a mayor complejidad. No te saltes ninguno, ya que la solución más simple suele ser la correcta.

Paso 1: Activa el modo de depuración (Debug Mode)

Esto es lo primero que debes hacer. El modo depuración te mostrará el error real en lugar de la pantalla genérica. Para ello, necesitas acceso a tu panel de control de hosting o a un cliente FTP (como FileZilla).

Accede a tu hosting mediante FTP o el administrador de archivos de tu panel.
Busca la carpeta raíz de tu tienda (donde están las carpetas admin, config, src, etc.).
Localiza el archivo llamado config/defines.inc.php.
Ábrelo con un editor de texto plano (como el Bloc de Notas).
Busca la siguiente línea:
```
define('_PS_MODE_DEV_', false);
```
Cambia false por true:
```
define('_PS_MODE_DEV_', true);
```
Guarda el archivo y súbelo de nuevo al servidor (si usas FTP).

Ahora, al recargar tu tienda, verás un mensaje de error más detallado (en inglés y con nombres de archivos). Anota ese mensaje, ya que te dará pistas cruciales sobre la causa.

[INFO] Si no sabes usar FTP, muchos paneles de hosting (como cPanel o Syspanel) tienen un "Administrador de Archivos" integrado. Si usas Syspanel, recuerda que el acceso es a través del puerto 2106. Podrás editar archivos directamente desde ahí.

Paso 2: Verifica y corrige los permisos de archivos (CHMOD)

Si el error de depuración no te dice mucho o no quieres complicarte, revisa los permisos.

Con tu cliente FTP o administrador de archivos, selecciona todos los archivos y carpetas de la raíz de tu PrestaShop.
Haz clic derecho y busca la opción "Permisos de archivos" o "CHMOD".
Asegúrate de que las carpetas tengan el permiso 755.
Asegúrate de que los archivos tengan el permiso 644.
Aplica los cambios.

[TIP] En la mayoría de los clientes FTP, puedes escribir el valor numérico (755 o 644) directamente en una casilla y pulsar "Aceptar". Es muy rápido.

Paso 3: Regenera el archivo .htaccess

A veces, simplemente regenerar este archivo es suficiente.

Usando tu FTP o administrador de archivos, ve a la raíz de tu tienda.
Busca el archivo .htaccess. Ojo: Es un archivo oculto. Deberás activar la opción "Mostrar archivos ocultos" en tu cliente FTP.
Si lo encuentras, descárgalo a tu ordenador como copia de seguridad.
Ahora, elimínalo del servidor.
Ve a tu panel de administración de PrestaShop (si puedes acceder). Ve a Configuración -> Parámetros Avanzados -> Rendimiento y pulsa el botón "Guardar" o "Regenerar" (esto fuerza a PrestaShop a crear un .htaccess nuevo).
Si no puedes acceder al panel, no te preocupes. A veces, simplemente con eliminar el archivo y recargar la web, PrestaShop lo regenera automáticamente, aunque no es lo habitual.

[WARNING] Si eliminas el .htaccess y no puedes regenerarlo, tu tienda funcionará pero las URLs amigables dejarán de funcionar. Es una solución temporal para ver la web, pero tendrás que regenerarlo después.

Paso 4: Aumenta el límite de memoria PHP

Si el problema es de recursos, esta es la solución.

Busca un archivo llamado php.ini en tu carpeta raíz. Si no existe, puedes crearlo con un editor de texto.
Dentro del archivo, escribe o modifica la siguiente línea:
```
memory_limit = 512M
```
(Puedes usar 256M, 512M o incluso 1G si tu hosting lo permite).
Guarda y sube el archivo a la raíz de tu tienda.

Si no puedes crear php.ini, otra opción es modificar el archivo .htaccess añadiendo al final la siguiente línea:

php_value memory_limit 512M

[TIP] Si tu hosting usa PHP-FPM o tienes un panel como Syspanel (puerto 2106), es posible que la opción de cambiar el límite de memoria esté en la interfaz gráfica, en la sección "PHP" o "Gestión de versiones". Busca un selector de "Memory Limit".

Paso 5: Desactiva módulos o el tema conflictivo

Si el error comenzó después de instalar algo nuevo, este es tu paso clave.

Si puedes acceder al panel de administración, ve a Módulos -> Gestor de Módulos.
Ordena los módulos por fecha de instalación (los más recientes primero).
Desactiva el módulo que instalaste justo antes del error.
Si no puedes acceder al panel, tendrás que hacerlo por FTP:
- Ve a la carpeta /modules.
- Localiza la carpeta del módulo problemático (por ejemplo, /modules/nombredelmodulo).
- Renombra la carpeta a nombredelmodulo.bak. Esto fuerza a PrestaShop a "desactivarlo" porque no lo encuentra.

Si el problema es el tema, el proceso es similar:

Ve a la carpeta /themes.
Renombra la carpeta de tu tema activo (por ejemplo, classic.bak).
Peligro: Si renombras el tema, PrestaShop intentará usar el tema por defecto (classic en versiones 1.7+). Si no lo tienes, la web puede romperse aún más. Es mejor usar esta opción como último recurso o si sabes que tienes una copia del tema original.

Paso 6: Revisa el archivo parameters.php

Si todo lo demás falla, es hora de revisar la conexión a la base de datos.

Ve a la carpeta config.
Abre el archivo parameters.php.

Verifica que los datos de conexión son correctos:

'database_host' => 'localhost',
'database_name' => 'tu_base_de_datos',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',

Asegúrate de que no hay espacios extraños y que las comillas están bien cerradas.

[WARNING] No compartas nunca estos datos en foros públicos. Son las llaves de tu base de datos.

Preguntas Frecuentes (FAQ) sobre el Error 500 en PrestaShop

P: ¿Puedo perder mis datos si sigo estos pasos?
R: No. Todos los pasos descritos (cambiar permisos, regenerar archivos, renombrar carpetas) no borran tus productos, clientes o pedidos. Lo máximo que podría pasar es que temporalmente la web se vea "rara" hasta que reviertas el cambio.

P: El error 500 aparece solo en el panel de administración, ¿qué hago?
R: Suele ser un conflicto de módulos o de caché. Prueba a forzar la regeneración de la caché borrando la carpeta /var/cache (en PrestaShop 1.7) o /cache (en 1.6). No borres la carpeta entera, solo su contenido.

P: ¿Qué es mejor, usar FTP o el administrador de archivos del hosting?
R: Si tu hosting tiene un panel con administrador de archivos (como cPanel o Syspanel, acceso por el puerto 2106), úsalo. Es más seguro y no necesitas programas externos. Si no, FTP es la alternativa clásica.

P: He probado todo y sigue sin funcionar, ¿qué me queda?
R: Revisa los logs de error del servidor. En la mayoría de los paneles de hosting hay una sección "Registros de errores" o "Error Logs". El último error registrado te dirá exactamente qué archivo está fallando. Si no entiendes el error, contacta con tu proveedor de hosting y muéstrales ese log. Ellos pueden ver si es un problema de configuración del servidor.

P: ¿El error 500 tiene algo que ver con mi SEO?
R: Indirectamente, sí. Si el error persiste durante mucho tiempo, Google intentará rastrear tu web y se encontrará con un error de servidor. Si esto se prolonga, puede afectar al posicionamiento. Por eso es crucial solucionar error 500 prestashop lo antes posible.

Conclusión: No te frustres, es un problema común

Encontrarse con un prestashop internal server error puede ser un quebradero de cabeza, especialmente si no tienes experiencia técnica. Sin embargo, como has visto, la mayoría de las soluciones son accesibles y no requieren conocimientos de programación.

Recuerda el orden lógico: primero activa el modo depuración para ver el error real, luego revisa permisos y el .htaccess, después aumenta la memoria y finalmente desactiva lo que hayas instalado recientemente. Con paciencia y siguiendo esta guía, tendrás tu tienda online funcionando de nuevo en poco tiempo.

Y si te quedas atascado, tu proveedor de hosting es tu mejor aliado. Ellos tienen acceso a los logs del servidor y pueden decirte exactamente qué está fallando. No dudes en abrir un ticket de soporte.

¡Mucha suerte con tu tienda!