Solucionar error 500 en PrestaShop con Plesk | Guía FAQ

¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto, seguramente te has topado con el temido error 500 en PrestaShop mientras usas Plesk. No te preocupes, es uno de los problemas más comunes en el mundo del hosting y, aunque parece un monstruo, tiene solución. En esta guía extensa y paso a paso, te voy a explicar cómo solucionar el error 500 PrestaShop en un entorno Plesk, desde lo más básico hasta lo más técnico (pero siempre fácil de entender). Vamos a ello.

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

El error 500 es un código de estado HTTP que significa «Error interno del servidor». En términos simples, el servidor web (Apache o Nginx) está confundido: no sabe cómo procesar tu solicitud porque algo falló en el código de PrestaShop, en la configuración del servidor o en los archivos del sistema. En Plesk, puede deberse a varias razones, como archivos con permisos incorrectos, un módulo PHP que falla, un .htaccess corrupto o incluso un error en la base de datos.

[INFO] El error 500 es un error genérico. Para diagnosticarlo, necesitamos activar los logs de errores. No te asustes, te guiaré paso a paso.

Paso 1: Lo primero, activar la visualización de errores en PrestaShop

Antes de tocar nada, debemos hacer que PrestaShop nos muestre el error real. Por defecto, en producción, los errores están ocultos. Vamos a activarlos temporalmente.

Accede a los archivos de configuración

Conéctate a tu panel de Plesk (normalmente en https://tudominio.com:8443 o la IP de tu servidor). Luego, ve a Archivos o Administrador de archivos en el dominio afectado.

Busca el archivo /config/defines.inc.php en la raíz de tu instalación de PrestaShop.
Ábrelo con el editor de texto de Plesk.
Busca la línea: define('_PS_MODE_DEV_', false);
Cámbiala por: define('_PS_MODE_DEV_', true);
Guarda los cambios.

Ahora, recarga la página que daba error. En lugar del error 500, verás un mensaje más descriptivo, como «Fatal error: Allowed memory size exhausted» o «Class not found». Eso nos dará pistas.

[TIP] Si no ves nada o sigue el error 500, puede que el problema esté en el servidor, no en PrestaShop. Sigue leyendo.

Paso 2: Revisa los logs de error del servidor en Plesk

Si la opción anterior no revela nada, toca mirar los logs del servidor. En Plesk, los logs están accesibles desde el panel.

Ve a Sitios web y dominios > selecciona tu dominio.
Busca la sección Logs o Registros (a veces está en un menú desplegable).
Abre el archivo error_log (Apache) o error.log (Nginx). Si usas Nginx, busca también en /var/log/nginx/.
Busca la línea con la fecha y hora del error. Verás algo como: PHP Fatal error: Allowed memory size of 134217728 bytes exhausted.

Ese mensaje es oro. Anótalo y lo usaremos para solucionar el problema.

Paso 3: Soluciones comunes para el error 500 en PrestaShop

Ahora que tenemos pistas, vamos a atacar las causas más frecuentes.

Aumentar el límite de memoria PHP

Uno de los culpables más comunes es que PHP se queda sin memoria. PrestaShop es pesado, sobre todo si tienes muchos módulos.

Cómo hacerlo en Plesk:

Ve a Sitios web y dominios > selecciona tu dominio.
Haz clic en Configuración de PHP (o PHP Settings).
Busca el parámetro memory_limit. Normalmente viene en 128M. Cámbialo a 256M o incluso 512M si tu hosting lo permite.
Guarda y vuelve a probar.

Si no tienes acceso a esa opción (porque tu plan de hosting lo limita), puedes hacerlo desde el archivo .htaccess o php.ini. Te muestro cómo:

Opción .htaccess: Añade esta línea al final del archivo .htaccess en la raíz:
```
php_value memory_limit 256M
```
Opción php.ini: Si existe un archivo php.ini en la raíz, añade:
```
memory_limit = 256M
```

[WARNING] No todos los hostings permiten modificar estos valores. Si no funciona, contacta con tu proveedor.

Verificar permisos de archivos y carpetas

Los permisos incorrectos son otra causa clásica. En Plesk, los archivos deben tener permisos 644 y las carpetas 755.

Cómo corregirlos desde Plesk:

Ve a Archivos en el dominio.
Selecciona todos los archivos y carpetas (Ctrl+A).
Haz clic en Permisos (o Permissions).
Asegúrate de que:
- Archivos: 644 (lectura y escritura para el propietario, solo lectura para grupos y otros).
- Carpetas: 755 (lectura, escritura y ejecución para el propietario; lectura y ejecución para grupos y otros).
Aplica los cambios.

Si tienes acceso SSH (y sabes usarlo), puedes ejecutar:

find . -type f -exec chmod 644 {} \;
find . -type d -exec chmod 755 {} \;

Revisar el archivo .htaccess

Un .htaccess corrupto o mal configurado puede provocar el error 500. PrestaShop genera uno automáticamente.

Pasos para regenerarlo:

Renombra el archivo .htaccess actual a .htaccess_old (desde el administrador de archivos).
Ve al panel de administración de PrestaShop (si puedes acceder) o desde la base de datos:
- Ve a Parámetros de la tienda > Tráfico y SEO > URLs amigables.
- Desactiva y vuelve a activar las URLs amigables. Esto regenerará el .htaccess.

Si no puedes acceder al panel, crea un archivo .htaccess nuevo con el contenido básico:

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

Deshabilitar módulos problemáticos

A veces un módulo recién instalado o actualizado causa el error. Si tienes acceso al panel de administración (aunque dé error 500 en el frontend), ve a Módulos y desactiva los que no sean esenciales. Si no puedes acceder, renombra la carpeta modules temporalmente:

Desde el administrador de archivos de Plesk, ve a la raíz de PrestaShop.
Renombra la carpeta modules a modules_backup.
Crea una nueva carpeta modules vacía.
Prueba la tienda. Si funciona, el problema era un módulo. Ve moviendo los módulos de la carpeta de backup de uno en uno hasta encontrar el culpable.

Verificar la versión de PHP

PrestaShop requiere una versión específica de PHP. Por ejemplo, PrestaShop 1.7 funciona bien con PHP 7.1 a 7.4, pero no con PHP 8.0+ sin parches. En Plesk, puedes cambiar la versión de PHP fácilmente:

Ve a Sitios web y dominios > selecciona tu dominio.
Haz clic en Configuración de PHP.
En la parte superior, elige una versión compatible (por ejemplo, 7.4).
Guarda y prueba.

[INFO] Si tu PrestaShop es muy antiguo (1.6 o anterior), usa PHP 5.6 o 7.0, pero ten en cuenta que esas versiones ya no reciben soporte de seguridad.

Paso 4: Soluciones avanzadas (SysAdmin)

Si nada de lo anterior funciona, toca ponerse el sombrero de SysAdmin. Aquí van técnicas más profundas.

Revisar la configuración de Apache/Nginx en Plesk

A veces el problema está en la configuración del servidor web. En Plesk, puedes acceder a los archivos de configuración de Apache o Nginx desde Herramientas y configuraciones > Configuración de Apache o Nginx.

Busca directivas como LimitRequestBody o Timeout que puedan estar limitando algo. Si no estás seguro, restaura la configuración por defecto.

Comprobar la base de datos

Un error en la base de datos también puede dar error 500. Desde Plesk, ve a Bases de datos y selecciona la de tu PrestaShop. Usa la herramienta phpMyAdmin para ejecutar:

REPAIR TABLE `ps_configuration`;

O simplemente repara todas las tablas:

REPAIR TABLE nombre_de_la_tabla;

Aumentar el límite de ejecución de PHP

Además de la memoria, el tiempo de ejecución puede ser insuficiente. En Configuración de PHP de Plesk, busca max_execution_time y cámbialo a 300 (segundos).

Reinstalar PrestaShop (último recurso)

Si todo falla, haz una copia de seguridad de la base de datos y los archivos (desde Plesk, usa la herramienta de backup) y reinstala PrestaShop. Luego restaura la base de datos y los archivos de temas y módulos.

FAQ: Preguntas frecuentes sobre el error 500 en PrestaShop con Plesk

P: ¿Por qué veo el error 500 solo en algunas páginas?
R: Puede ser un módulo específico o una plantilla corrupta. Prueba a desactivar módulos o cambiar temporalmente al tema por defecto.

P: El error 500 aparece después de una actualización de PrestaShop. ¿Qué hago?
R: Las actualizaciones pueden romper la compatibilidad con módulos o la versión de PHP. Revisa los logs y desactiva módulos no compatibles.

P: No tengo acceso al panel de administración. ¿Cómo soluciono el error 500?
R: Usa el administrador de archivos de Plesk para modificar archivos directamente. Sigue los pasos de esta guía (logs, permisos, .htaccess).

P: ¿El error 500 puede ser culpa del hosting?
R: Sí. A veces el servidor tiene recursos insuficientes (memoria, CPU) o configuraciones restrictivas. Contacta a tu proveedor de hosting.

P: ¿Cómo evito futuros errores 500?
R: Mantén PrestaShop, módulos y PHP actualizados. Haz copias de seguridad periódicas y revisa los logs de error semanalmente.

Conclusión

El error 500 en PrestaShop en Plesk puede parecer un problema de otro mundo, pero con paciencia y los pasos que te he dado, podrás resolverlo. Recuerda: empieza por activar los errores, revisa los logs, y luego aplica las soluciones una por una. Si eres SysAdmin, no dudes en profundizar en la configuración del servidor.

[TIP] Si después de todo esto el error persiste, contacta a tu proveedor de hosting. A veces el problema está en el hardware o en la configuración global del servidor.

Espero que esta guía te haya sido de ayuda. ¡No dudes en volver si tienes más dudas!