Cómo arreglar error 500 en PrestaShop | Guía panel control

¡Hola! Soy tu técnico de soporte amigable. Entiendo lo frustrante que puede ser encontrarse con un error 500 en PrestaShop. Es un error genérico del servidor, pero no te preocupes, en la mayoría de los casos se puede solucionar desde el propio panel de control, sin necesidad de ser un experto en programación.

En esta guía completa, te explicaré paso a paso cómo solucionar error 500 en PrestaShop utilizando herramientas que tienes a mano en tu PrestaShop panel control. Vamos a desglosar las causas y las soluciones más comunes.

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

Un error 500 es un mensaje que indica que algo salió mal en el servidor, pero no te da detalles específicos. Es como si el coche se parara pero el testigo del motor no te dijera si es la batería o el carburador. En PrestaShop, las causas más habituales suelen ser:

Problemas de memoria PHP: Tu tienda necesita un mínimo de memoria para funcionar. Si se queda corta, da error.
Módulos o temas incompatibles: Una actualización o instalación reciente puede haber roto algo.
Archivos .htaccess corruptos: Este archivo es como el directorio de tráfico de tu web; si se estropea, se bloquea todo.
Permisos de archivos incorrectos: El servidor necesita poder leer y escribir ciertos archivos. Si no tiene permiso, falla.
Errores en el archivo settings.inc.php: Este archivo contiene la configuración de conexión a la base de datos.

Vamos a solucionarlo desde tu panel de control, paso a paso.

Primero: Accede a tu Panel de Control y Activa el Modo Debug

Antes de nada, necesitamos que el error 500 nos dé más pistas. PrestaShop tiene un modo debug que muestra el error real. Para activarlo, necesitas editar un archivo desde el panel de control.

Paso 1: Accede al Administrador de Archivos

La mayoría de los paneles de control (como cPanel, Plesk o Syspanel) tienen un Administrador de Archivos. Busca esta opción. Si tu panel es Syspanel (antes conocido como HestiaCP), recuerda que accedes por el puerto 2106 (ejemplo: tudominio.com:2106).

Paso 2: Encuentra el archivo config/defines.inc.php

Dentro del Administrador de Archivos, navega hasta la carpeta donde está instalado PrestaShop. Normalmente es public_html o www. Dentro, busca la carpeta config y dentro de ella el archivo defines.inc.php.

Paso 3: Edita el archivo para activar el modo debug

Haz clic derecho sobre el archivo defines.inc.php y selecciona Editar (o Edit). Busca esta línea:

define('_PS_MODE_DEV_', false);

Cámbiala por:

define('_PS_MODE_DEV_', true);

Guarda los cambios. Ahora, al recargar tu tienda, en lugar del error 500 genérico, verás un mensaje de error más específico, como por ejemplo: "Fatal error: Allowed memory size of...".

[TIP] Apunta el mensaje de error que veas. Nos servirá más adelante para afinar la solución.

Soluciones Comunes para el Error 500 en PrestaShop

Ahora que tienes el modo debug activado (o aunque no veas el error concreto), vamos a probar las soluciones más efectivas. Siempre ve de la más simple a la más compleja.

Solución 1: Aumentar la Memoria PHP

Este es el culpable más frecuente. Muchos servidores tienen un límite de memoria bajo (por ejemplo, 64M o 128M) y PrestaShop necesita al menos 256M.

¿Cómo hacerlo desde el panel de control?

Opción A (La más fácil): Busca "Select PHP Version" o "MultiPHP Manager". En cPanel o Plesk, hay una opción para gestionar la versión de PHP. Dentro, verás una pestaña o sección llamada Options o Switch to PHP Options. Busca memory_limit y cámbialo a 256M o incluso 512M. Guarda los cambios.
Opción B (Editando un archivo): Si no encuentras la opción anterior, puedes forzarlo desde el archivo .htaccess. Vuelve al Administrador de Archivos, busca el archivo .htaccess (en la raíz de tu instalación de PrestaShop, normalmente public_html). Ábrelo para editarlo y, al principio del archivo, pega estas líneas:
```
<IfModule mod_php7.c>
    php_value memory_limit 256M
    php_value max_execution_time 120
</IfModule>
```
Guarda el archivo. Recarga tu tienda. Si el error desaparece, ¡problema resuelto!

[WARNING] Si tu servidor usa PHP 8.x, cambia mod_php7.c por mod_php8.c en el código anterior. Si no sabes qué versión usas, revisa la opción "Select PHP Version" de tu panel.

Solución 2: Deshabilitar Módulos o Temas Problemáticos

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

¿Cómo deshabilitarlos sin acceso al panel de administración?

Renombrar la carpeta del módulo: Desde el Administrador de Archivos, ve a la carpeta modules dentro de tu PrestaShop. Busca la carpeta del módulo que sospechas (por ejemplo, superplugin). Cámbiale el nombre a superplugin_old (o cualquier otro nombre). Esto desactivará el módulo.
Renombrar la carpeta del tema: Si el problema es el tema, ve a la carpeta themes. Busca la carpeta de tu tema activo (por ejemplo, mi-tema) y renómbrala a mi-tema_old. PrestaShop usará el tema por defecto (generalmente classic). Si el error desaparece, el tema es el culpable.

Recarga la tienda después de cada cambio. Si el error se soluciona, ya sabes qué causó el problema.

Solución 3: Regenerar el archivo .htaccess

Un archivo .htaccess corrupto o mal generado puede provocar un error 500. Vamos a forzar a PrestaShop a que lo regenere.

Desde el Administrador de Archivos, localiza el archivo .htaccess en la raíz de tu instalación.
No lo borres aún. Simplemente, renómbralo a .htaccess_old (o .htaccess.backup). Esto lo desactiva temporalmente.
Ahora, accede a tu tienda. Si ves un error diferente (como "URL rewriting error" o "404"), es buena señal: el problema era el .htaccess.
Para regenerarlo, accede a tu panel de administración de PrestaShop (si puedes) y ve a Configuración de la tienda > Tráfico y SEO > SEO y URLs. Simplemente haz clic en Guardar sin cambiar nada. PrestaShop creará un nuevo .htaccess.

[INFO] Si no puedes acceder al panel de administración, no te preocupes. A veces, con solo renombrar el archivo, la tienda ya funciona. Luego, desde el panel de administración (si logras entrar), ya lo regeneras.

Solución 4: Verificar y Corregir Permisos de Archivos

Los permisos incorrectos son otra causa común. Los archivos deben tener permiso 644 y las carpetas 755.

¿Cómo corregirlos desde el panel?

Opción rápida (si tu panel lo permite): En cPanel, busca File Permissions o File Manager. Selecciona toda la carpeta de tu tienda (por ejemplo, public_html). Busca la opción Change Permissions.
- Marca las casillas para que quede en 755 para carpetas.
- Marca las casillas para que quede en 644 para archivos.
- Activa la opción Recursive (para que se aplique a todas las subcarpetas y archivos). Haz clic en Change.
Opción manual (más lenta pero segura): Si no tienes la opción masiva, ve carpeta por carpeta y archivo por archivo, pero es tedioso. Recomiendo la opción 1.

Solución 5: Revisar el archivo settings.inc.php (Conexión a la Base de Datos)

Este archivo contiene los datos de conexión a tu base de datos. Si está dañado, la tienda no puede arrancar.

Ve a la carpeta config dentro de tu PrestaShop.
Busca el archivo settings.inc.php. Ábrelo para editarlo.
Verifica que los datos sean correctos:
- _DB_SERVER_ (normalmente localhost o la IP del servidor).
- _DB_NAME_ (el nombre de tu base de datos).
- _DB_USER_ (el usuario de la base de datos).
- _DB_PASSWD_ (la contraseña).
Si no estás seguro, puedes obtener estos datos desde la sección Bases de Datos de tu panel de control. Si los datos son incorrectos, corrígelos y guarda el archivo.

¿Sigues con el error 500? Activa el Log de Errores del Servidor

Si después de todo lo anterior el error persiste, necesitamos más información. Los paneles de control suelen tener un Registro de Errores (Error Log).

En cPanel: Busca la sección Metrics o Logs y haz clic en Errors o Error Log.
En Syspanel: Ve a la sección Logs (a menudo dentro de la configuración del dominio).
En Plesk: Busca Logs > Error Log.

Ahí verás las últimas líneas de error del servidor. Busca líneas que contengan "PrestaShop" o "PHP Fatal error". Te darán la pista definitiva.

FAQ: Preguntas Frecuentes sobre el Error 500 en PrestaShop

P: ¿El error 500 puede deberse a una mala configuración de la base de datos?

R: Sí, absolutamente. Si el archivo settings.inc.php tiene datos incorrectos (usuario, contraseña, nombre de la base de datos), PrestaShop no podrá conectarse y lanzará un error 500. La Solución 5 explica cómo revisarlo.

P: Mi panel de control no tiene la opción de cambiar la memoria PHP desde la interfaz. ¿Qué hago?

R: No te preocupes. Puedes forzarlo desde el archivo .htaccess como se explica en la Solución 1 (Opción B). Si eso no funciona, contacta con tu proveedor de hosting y pídele que aumente el memory_limit a 256M o 512M.

P: Después de renombrar un módulo, la tienda funciona, pero al intentar borrarlo desde el panel de administración, no puedo. ¿Qué hago?

R: Es normal. Al renombrar la carpeta, PrestaShop ya no lo reconoce como instalado. Para eliminarlo de forma segura, desde el Administrador de Archivos, borra la carpeta que renombraste (ej: superplugin_old). Luego, desde el panel de administración, revisa la lista de módulos; debería aparecer como "No instalado" y podrás borrarlo.

P: ¿El error 500 puede ser un ataque o un virus?

R: Es poco común, pero posible. Si tu tienda ha sido hackeada, podrían haber modificado archivos clave. Revisa que no haya archivos extraños en la raíz o en la carpeta modules con nombres sospechosos (ej: shell.php). Si sospechas, contacta con tu hosting para que revisen los logs de seguridad.

P: Ya probé todo y sigue el error. ¿Qué hago?

R: No te desesperes. Activa el modo debug (paso inicial) y anota el mensaje de error exacto. Luego, ve al Error Log del servidor (FAQ anterior). Con esa información, contacta al soporte técnico de tu hosting. Diles el mensaje de error y ellos podrán ayudarte más rápido. Recuerda que siempre puedes pedir ayuda en foros especializados de PrestaShop.

¡Espero que esta guía te haya sido de gran ayuda! Recuerda que la paciencia y seguir los pasos en orden son la clave para solucionar error 500 en PrestaShop desde tu panel de control. Si tienes más dudas, no dudes en preguntar. ¡Buena suerte con tu tienda!