¿Cómo resolver errores 500 en PrestaShop con Plesk?

¿Te ha pasado que tu tienda PrestaShop se vuelve invisible de repente, mostrando solo una pantalla en blanco o un mensaje de error 500? No te preocupes, es uno de los problemas más comunes en el mundo del hosting y, por suerte, casi siempre tiene solución. En esta guía completa, te voy a explicar paso a paso cómo solucionar el temido error 500 PrestaShop cuando tu sitio está alojado en un servidor con Plesk. Vamos a ir desde lo más básico hasta trucos avanzados, todo explicado de forma sencilla.

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

El error 500 es un código de estado HTTP que significa "Error interno del servidor". Básicamente, el servidor (tu hosting) no puede completar la petición que le hace tu navegador porque algo falló en el proceso. En PrestaShop, las causas más frecuentes son:

• Problemas de permisos de archivos o carpetas: PrestaShop necesita permisos específicos para leer y escribir datos.
• Errores en el archivo .htaccess: Este archivo controla reglas de redirección y seguridad; si está dañado, el servidor se bloquea.
• Módulos o temas incompatibles: Una actualización o instalación reciente puede causar conflictos.
• Límites de memoria PHP excedidos: Si tu tienda tiene muchos productos o tráfico, puede necesitar más memoria.
• Archivos corruptos o faltantes: Después de una migración o actualización, algún archivo clave puede haberse dañado.

[INFO] No confundas el error 500 con el error 503. El 503 indica que el servidor está sobrecargado o en mantenimiento, mientras que el 500 es un fallo interno que normalmente puedes arreglar desde el panel de control.

Paso 1: Lo primero, accede a los logs de error en Plesk

Antes de empezar a tocar archivos al azar, necesitas saber qué está pasando exactamente. Los logs de error son como el "diario secreto" de tu servidor. En Plesk, puedes encontrarlos fácilmente.

1. Inicia sesión en tu panel de Plesk (normalmente es algo como https://tudominio.com:8443).
2. Ve a Sitios web y dominios y selecciona el dominio de tu tienda PrestaShop.
3. Busca la sección Logs (normalmente en la parte inferior del menú).
4. Haz clic en Error log o Registro de errores. Verás una lista de líneas con marcas de tiempo y descripciones.

Busca las líneas que contengan "PHP Fatal error" o "500 Internal Server Error". Por ejemplo, algo como:

[30-Oct-2023 10:15:23 UTC] PHP Fatal error:  Allowed memory size of 134217728 bytes exhausted (tried to allocate 20480 bytes) in /var/www/vhosts/tudominio.com/httpdocs/config/config.inc.php on line 42

Este mensaje te dice exactamente qué falló. En este caso, la memoria PHP se agotó. Anota la ruta del archivo y la línea, porque te servirá más adelante.

[TIP] Si no ves logs, asegúrate de que el registro de errores esté habilitado en Plesk. Ve a PHP Settings y activa "Display errors" o "Log errors" temporalmente mientras resuelves el problema.

Paso 2: Soluciona los problemas de permisos de archivos

Uno de los culpables más comunes del error 500 PrestaShop son los permisos incorrectos. PrestaShop necesita que ciertas carpetas sean escribibles (permisos 755 o 777) y los archivos sean legibles (644). Sigue estos pasos:

1. Conéctate a tu servidor mediante FTP (FileZilla, por ejemplo) o usa el administrador de archivos de Plesk.
2. Navega a la carpeta raíz de tu PrestaShop (normalmente /httpdocs o public_html).
3. Cambia los permisos de las siguientes carpetas a 755 (o 777 en casos extremos):
   • /cache
   • /log
   • /img
   • /mails
   • /modules
   • /themes/default/modules
   • /upload
   • /download
4. Los archivos deben tener permisos 644. Puedes hacerlo recursivamente con un cliente FTP seleccionando todos los archivos y aplicando el permiso.

[WARNING] No pongas permisos 777 en todo el sitio. Solo en las carpetas necesarias y temporalmente. Después de solucionar el error, vuelve a 755 para mayor seguridad.

Si no estás seguro de cómo hacerlo, en Plesk ve a Archivos y selecciona la carpeta, luego haz clic en Permisos para ajustarlos.

Paso 3: Reinicia o regenera el archivo .htaccess

El archivo .htaccess de PrestaShop es sensible. Si se corrompe, el servidor Apache se vuelve loco y te da el error 500. Para solucionarlo:

1. Accede por FTP o administrador de archivos a la raíz de tu tienda.
2. Localiza el archivo .htaccess (puede estar oculto, así que activa la opción de "Mostrar archivos ocultos" en tu cliente FTP).
3. Renómbralo a .htaccess_backup (por si acaso).
4. Ahora ve al panel de administración de PrestaShop (si puedes acceder) o genera uno nuevo desde la raíz. Si no puedes acceder al admin, crea un archivo nuevo con el siguiente contenido básico:

# START PrestaShop
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [QSA,L]
</IfModule>
# END PrestaShop

Guárdalo como .htaccess y súbelo a la raíz. Luego, desde el back office de PrestaShop (si logras entrar), ve a Configuración > Parámetros de la tienda > Tráfico y SEO y haz clic en "Guardar" para regenerar el archivo correctamente.

[INFO] Si tu servidor usa Nginx en lugar de Apache, el error 500 puede deberse a reglas de reescritura. En Plesk, ve a Apache y Nginx y asegúrate de que esté seleccionado "Apache" como servidor web principal.

Paso 4: Aumenta la memoria PHP y otros límites

El error 500 a menudo se debe a límites de memoria bajos. En Plesk, puedes ajustarlos fácilmente:

1. En el panel de Plesk, ve a Sitios web y dominios y selecciona tu dominio.
2. Haz clic en PHP Settings (o Configuración de PHP).
3. Busca la opción memory_limit y cámbiala a un valor más alto, por ejemplo 256M o 512M. También puedes aumentar:
   • max_execution_time a 300
   • upload_max_filesize a 64M
   • post_max_size a 64M
4. Guarda los cambios. El servidor se reiniciará automáticamente.

Después de esto, prueba tu tienda de nuevo. Si el error persiste, puede que necesites modificar el archivo config/defines.inc.php de PrestaShop. Busca la línea:

define('_PS_MODE_DEV_', false);

Cámbiala temporalmente a true para ver mensajes de error detallados en pantalla. No olvides volver a ponerla en false después de solucionar el problema, o tu tienda mostrará información sensible a los visitantes.

Paso 5: Desactiva módulos y temas sospechosos

A veces, un módulo o tema recién instalado es el culpable. Si no puedes acceder al back office, usa FTP para desactivarlos manualmente:

1. Conéctate por FTP y ve a /modules.
2. Renombra la carpeta del módulo sospechoso (por ejemplo, mimodulo a mimodulo_desactivado). Esto lo desactiva.
3. También puedes renombrar la carpeta del tema activo en /themes (por ejemplo, mi-tema a mi-tema_backup). PrestaShop usará el tema predeterminado.
4. Prueba tu tienda. Si funciona, ya sabes qué causó el error. Vuelve a activar los módulos de uno en uno para identificar al culpable.

[TIP] Si no sabes qué módulo desactivar, revisa los logs de error. Busca líneas que mencionen el nombre de un módulo específico.

Paso 6: Verifica la integridad de los archivos de PrestaShop

Si nada de lo anterior funciona, es posible que algún archivo central de PrestaShop esté dañado. Puedes repararlo reinstalando los archivos principales sin perder datos:

1. Descarga la misma versión de PrestaShop que tienes instalada desde el sitio oficial (prestashop.com).
2. Descomprime el archivo en tu computadora.
3. Sube solo las carpetas /admin, /classes, /controllers, /config, /core, /override y /tools a tu servidor, sobrescribiendo los archivos existentes. No subas la carpeta /install.
4. También puedes subir el archivo index.php y .htaccess desde el paquete original.

[WARNING] No subas la carpeta /themes ni /modules del paquete original, porque sobrescribirían tus personalizaciones. Solo los archivos del núcleo.

Paso 7: Limpia la caché de PrestaShop

La caché puede almacenar configuraciones corruptas. Para limpiarla manualmente:

1. Conéctate por FTP y elimina todo el contenido de la carpeta /cache/smarty/cache y /cache/smarty/compile.
2. También puedes eliminar el contenido de /cache/cachefs (si existe).
3. Luego, desde el back office (si accedes), ve a Parámetros avanzados > Rendimiento y haz clic en "Limpiar caché" y "Forzar compilación".

Si no puedes acceder al admin, simplemente borra las carpetas vacías y vuelve a crearlas con permisos 755.

Preguntas frecuentes (FAQ)

¿Por qué aparece el error 500 solo en algunas páginas?

Esto suele indicar un problema con un módulo específico o una plantilla. Revisa los logs de error para ver qué archivo está fallando. También puede ser un problema de memoria en páginas con muchos productos (como categorías grandes).

¿Puedo usar Syspanel (HestiaCP) para solucionar este error?

Si tu hosting usa Syspanel (HestiaCP), el proceso es similar, pero accedes por el puerto 2106 (por ejemplo, https://tudominio.com:2106). Allí encontrarás opciones de logs, permisos y PHP settings. Los pasos son los mismos: revisa logs, ajusta memoria y permisos.

¿El error 500 puede deberse a una actualización de PHP?

Sí. PrestaShop 1.6 no es compatible con PHP 8.0 o superior, y versiones antiguas de PrestaShop 1.7 pueden tener problemas con PHP 8.1. En Plesk, ve a PHP Settings y cambia la versión a una compatible (por ejemplo, PHP 7.4 para PrestaShop 1.7). Consulta la documentación de tu versión.

¿Qué hago si no puedo acceder al back office de PrestaShop?

Usa FTP para desactivar módulos, renombrar el archivo .htaccess y limpiar la caché manualmente. También puedes habilitar el modo de desarrollo en config/defines.inc.php para ver errores en pantalla.

¿Es seguro aumentar la memoria PHP a 512M?

Sí, siempre que tu plan de hosting lo permita. Si el servidor tiene suficiente RAM, no hay problema. Si ves que el error persiste incluso con memoria alta, puede ser un problema de código (como un bucle infinito) que debes revisar en los logs.

Mantenimiento preventivo para evitar futuros errores 500

Una vez que hayas solucionado el error, te recomiendo seguir estas buenas prácticas:

• Actualiza PrestaShop y sus módulos regularmente: Las versiones antiguas tienen bugs que pueden causar errores.
• Haz copias de seguridad semanales: Tanto de archivos como de la base de datos. Plesk tiene herramientas automáticas en Copias de seguridad.
• Monitorea los logs de error: Revisa los logs una vez al mes para detectar problemas antes de que se conviertan en errores 500.
• No instales módulos de fuentes dudosas: Prioriza el marketplace oficial de PrestaShop.
• Configura un límite de memoria realista: No pongas 512M si tu tienda es pequeña; 128M suele ser suficiente para la mayoría.

[INFO] Si después de todo esto el error 500 persiste, contacta a tu proveedor de hosting. Puede ser un problema de configuración del servidor (como un firewall o un límite de recursos) que solo ellos pueden solucionar.

Espero que esta guía te haya ayudado a resolver el error 500 PrestaShop en Plesk. Recuerda que la paciencia y la revisión metódica de los logs son tus mejores aliados. ¡Buena suerte con tu tienda!