Error 500 en PrestaShop Plesk: causas y soluciones | FAQ técnica

¡Hola! Soy tu técnico de soporte amigable. ¿Tienes una tienda en PrestaShop y te aparece un molesto error 500? No te preocupes, es uno de los problemas más comunes, pero también uno de los más fáciles de solucionar si sabes por dónde empezar. En esta guía, te voy a explicar paso a paso cómo diagnosticar y solucionar el error 500 PrestaShop cuando tu sitio está alojado en un panel Plesk. Vamos a convertir ese Plesk error interno en un recuerdo lejano.

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

Un error 500, también conocido como error interno del servidor, es la forma que tiene tu servidor de decir: "Algo salió mal, pero no puedo darte más detalles por seguridad". En PrestaShop, las causas más frecuentes son:

Problemas de permisos de archivos o carpetas.
Un archivo .htaccess corrupto o mal configurado.
Módulos o temas incompatibles.
Límites de memoria de PHP excedidos.
Errores en la configuración de la base de datos.

Lo bueno es que, con Plesk, tenemos herramientas muy visuales para resolverlo. Vamos paso a paso.

Paso 1: Activar el modo debug de PrestaShop (para ver el error real)

Antes de tocar nada, necesitamos que PrestaShop nos cuente qué está fallando exactamente. Por defecto, el error 500 es muy genérico. Activar el modo debug te mostrará el mensaje real.

### Cómo activar el modo debug desde Plesk

Accede a tu panel de Plesk (normalmente en https://tudominio.com:8443).
Ve a Archivos > Administrador de archivos.
Navega hasta la carpeta raíz de tu tienda (donde está el index.php).
Busca el archivo config/defines.inc.php.
Haz clic derecho sobre él y selecciona Editar en el editor de texto.
Busca la línea que dice:
define('_PS_MODE_DEV_', false);
Cámbiala a:
define('_PS_MODE_DEV_', true);
Guarda los cambios.

[INFO] Al activar esto, en lugar del error 500 genérico, verás un mensaje como "Fatal error: Allowed memory size of X bytes exhausted" o "Class not found". Eso es exactamente lo que necesitamos.

¿Qué hago si no encuentro el archivo?
Si no ves defines.inc.php, puede que tu PrestaShop esté en una versión antigua. Entonces, edita el archivo config/config.inc.php y añade al final:
@ini_set('display_errors', 'on');

Paso 2: Solucionar los problemas de permisos de archivos (causa más común)

El error 500 PrestaShop suele aparecer cuando los permisos de archivos o carpetas no son correctos. En Plesk, es muy fácil ajustarlos.

### Cómo restaurar permisos correctos en Plesk

En Plesk, ve a Sitios web y dominios > selecciona tu dominio.
Haz clic en Permisos de archivos (o Reparar permisos, según la versión).
Plesk te mostrará una opción para Restablecer permisos a los valores predeterminados. Actívala.
Haz clic en Aceptar.

Esto asignará:

Carpetas: 755 (lectura, escritura y ejecución para el propietario; lectura y ejecución para otros).
Archivos: 644 (lectura y escritura para el propietario; solo lectura para otros).

[WARNING] No uses permisos 777 en producción. Es un riesgo de seguridad enorme. Si algún módulo te lo pide, mejor busca otra alternativa.

Paso 3: Revisar el archivo .htaccess (otro gran culpable)

Un archivo .htaccess corrupto puede generar un Plesk error interno inmediato. Vamos a regenerarlo.

### Cómo regenerar el .htaccess en PrestaShop

Desde el Administrador de archivos de Plesk, localiza el archivo .htaccess en la raíz de tu tienda.
Renómbralo a htaccess_old (por si acaso).
Ahora, accede a tu panel de administración de PrestaShop (si puedes entrar).
- Ve a Configuración > Rendimiento.
- Haz clic en Regenerar archivo .htaccess.
Si no puedes acceder al panel, crea uno nuevo manualmente:
Crea un archivo vacío llamado .htaccess y pégalo el contenido básico de PrestaShop (puedes copiarlo de una instalación limpia o pedírselo a tu soporte).

[TIP] Si usas redirecciones personalizadas o reglas SEO, asegúrate de que no haya errores de sintaxis. Un solo carácter mal puede tirar todo.

Paso 4: Aumentar la memoria PHP (límite de memoria)

Muchas veces el error 500 PrestaShop aparece porque tu tienda necesita más memoria de la que tiene asignada. En Plesk, ajustar esto es muy sencillo.

### Cómo aumentar el límite de memoria PHP en Plesk

En Plesk, ve a Sitios web y dominios > selecciona tu dominio.
Haz clic en Configuración de PHP (o PHP Settings).
Busca la opción memory_limit.
Cámbiala a un valor más alto, por ejemplo: 256M o 512M. Si tu tienda tiene muchos productos o módulos, incluso 1024M.
También revisa max_execution_time y ponlo a 300 (segundos).
Guarda los cambios.

[INFO] Si no ves la opción, asegúrate de que tu plan de hosting te permita modificarla. En algunos planes compartidos, el límite está fijado por el proveedor.

Paso 5: Desactivar módulos problemáticos (sin acceso al panel)

Si el error impide que entres al administrador, podemos desactivar módulos desde la base de datos o mediante FTP.

### Opción A: Desactivar módulos desde la base de datos (con phpMyAdmin en Plesk)

En Plesk, ve a Bases de datos > selecciona la base de datos de tu tienda.
Haz clic en phpMyAdmin.
Busca la tabla ps_module (el prefijo puede ser diferente, como prestashop_module).
Haz clic en Examinar (o Browse).
Busca el módulo que instalaste justo antes del error. Por ejemplo, si instalaste "Módulo X", búscalo en la columna name.
Marca la fila y haz clic en Editar.
Cambia el campo active de 1 a 0.
Guarda.

### Opción B: Desactivar módulos manualmente (por FTP)

Conéctate a tu servidor vía FTP (o usa el Administrador de archivos de Plesk).
Ve a la carpeta /modules.
Renombra la carpeta del módulo sospechoso, por ejemplo, de mimodulo a mimodulo_off.
Vuelve a cargar tu tienda. Si funciona, ya sabes quién es el culpable.

[WARNING] No borres la carpeta del módulo, solo renómbrala. Así podrás reactivarlo más tarde si era un falso positivo.

Paso 6: Verificar el tema activo (el culpable silencioso)

A veces el error 500 PrestaShop aparece porque el tema tiene un error de sintaxis o no es compatible con tu versión.

### Cómo cambiar al tema predeterminado

En el Administrador de archivos de Plesk, ve a /themes.
Busca la carpeta de tu tema activo (normalmente se llama como tu tema).
Renómbrala a tema_antiguo.
PrestaShop usará automáticamente el tema por defecto (classic en versiones recientes).
Si el error desaparece, el tema es el problema. Contacta al desarrollador.

Paso 7: Limpiar la caché de PrestaShop (sin acceso al panel)

La caché corrupta también puede causar Plesk error interno. Vamos a limpiarla manualmente.

### Cómo limpiar la caché manualmente

En el Administrador de archivos, ve a la carpeta /var/cache (o /cache en versiones antiguas).
Elimina todo el contenido de las carpetas smarty/cache y smarty/compile.
No borres las carpetas en sí, solo los archivos de dentro.

[TIP] También puedes eliminar el contenido de /cache/tcpdf y /cache/purifier para una limpieza más profunda.

Paso 8: Revisar los logs del servidor en Plesk (el diagnóstico final)

Si nada de lo anterior funciona, los logs del servidor te darán la pista definitiva.

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

En Plesk, ve a Sitios web y dominios > selecciona tu dominio.
Haz clic en Registros (o Logs).
Busca el archivo error_log (o php_error.log).
Descárgalo o ábrelo en el visor de Plesk.
Busca la línea que coincida con la hora en que viste el error 500. Allí aparecerá el mensaje real.

Ejemplo de lo que podrías ver:
[16-Mar-2025 14:32:15] PHP Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate 40960 bytes) in /var/www/vhosts/tudominio.com/httpdocs/classes/module/Module.php on line 1234

Eso te dice exactamente qué archivo y línea fallan.

Preguntas frecuentes (FAQ)

¿Puedo solucionar el error 500 sin acceso al panel de administración de PrestaShop?

Sí, absolutamente. Todos los pasos que te he dado se pueden hacer desde Plesk o FTP, sin necesidad de entrar al backoffice. De hecho, es lo más común cuando el error bloquea el acceso.

¿El error 500 puede deberse a un plugin de SEO o de caché?

Sí, módulos como los de caché (por ejemplo, "Advanced Cache" o "Page Cache") o algunos plugins SEO que modifican el .htaccess suelen ser los principales sospechosos. Si instalaste uno justo antes del error, desactívalo primero.

¿Qué hago si el error persiste después de seguir todos los pasos?

Si ya has probado todo (permisos, .htaccess, memoria, módulos, tema y logs), el problema puede ser más profundo: versión de PHP incompatible, falta de extensiones (como curl, gd o mysqli) o incluso un error en la base de datos. Te recomiendo:

Verificar la versión de PHP en Plesk (ve a Configuración de PHP y asegúrate de que sea compatible con tu PrestaShop, generalmente 7.4 u 8.0).
Reparar la base de datos desde phpMyAdmin (marca todas las tablas y elige "Reparar tabla").
Si nada funciona, contacta a tu proveedor de hosting con el log de error en mano.

¿Es seguro activar el modo debug en producción?

Solo momentáneamente. Una vez que obtengas el mensaje de error, vuelve a desactivarlo (cambia _PS_MODE_DEV_ a false). Dejarlo activo expone información sensible a los visitantes.

Resumen rápido: checklist para solucionar el error 500

Activar modo debug para ver el error real.
Restablecer permisos de archivos desde Plesk.
Regenerar o reemplazar el .htaccess.
Aumentar el límite de memoria PHP.
Desactivar módulos recientes (desde BD o renombrando carpetas).
Cambiar al tema por defecto.
Limpiar la caché manualmente.
Revisar los logs del servidor.

Con esta guía, ya tienes todas las herramientas para solucionar error 500 tienda PrestaShop alojada en Plesk. Recuerda que la paciencia y el método son clave. Si te atascas, vuelve a leer los pasos o consulta los logs. ¡Tu tienda volverá a funcionar en poco tiempo!

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), recuerda que el puerto de acceso es el 2106. Los pasos son similares, pero la interfaz cambia ligeramente. En ese caso, busca la sección de "Archivos" o "Base de datos" para aplicar los mismos principios.

Espero que esta guía te haya sido de gran ayuda. Si tienes alguna duda, no dudes en preguntar. ¡Estoy aquí para ayudarte!