Cómo resolver el error 500 en PrestaShop (Plesk)

¿Por qué aparece el error 500 en PrestaShop y Plesk?

Ver un error 500 prestashop plesk en tu tienda online es de las experiencias más frustrantes que existen. Un momento tienes tu negocio funcionando y al siguiente, los clientes ven una pantalla en blanco con un mensaje críptico. Pero respira hondo: este error es más común de lo que piensas y, en la mayoría de los casos, tiene solución en pocos minutos.

El prestashop internal server error es un error genérico del servidor. Esto significa que algo falló en el servidor, pero PrestaShop no puede especificar exactamente qué es. La buena noticia es que, al trabajar con Plesk, tienes herramientas muy potentes para diagnosticar el problema. A lo largo de esta guía, aprenderás paso a paso cómo resolverlo, incluso si nunca has tocado un archivo de configuración en tu vida.

Antes de empezar: prepara tu entorno de trabajo

Para solucionar el solucion error 500 prestashop, necesitarás acceder a dos herramientas principales:

1. Panel de control Plesk: Es donde gestionas tu dominio, bases de datos y archivos. Normalmente accedes a través de https://tudominio.com:8443.

2. Administrador de archivos: Dentro de Plesk, en la sección "Archivos", puedes ver y editar todos los archivos de tu tienda sin necesidad de un cliente FTP.

IMPORTANTE: Antes de hacer cualquier cambio, crea una copia de seguridad completa. En Plesk, ve a la sección "Copias de seguridad" y genera una copia manual. Esto te permitirá revertir cualquier cambio si algo sale mal.

Paso 1: Activa el modo debug de PrestaShop

El primer paso para diagnosticar el prestashop plesk error es hacer que PrestaShop te diga exactamente qué está fallando. Por defecto, el modo debug está desactivado, así que tendrás que activarlo manualmente.

Cómo activar el modo debug

1. Accede al Administrador de archivos en Plesk.

2. Navega hasta la carpeta raíz de tu instalación de PrestaShop (normalmente httpdocs o public_html).

3. Busca el archivo config/defines.inc.php.

4. Haz clic derecho sobre él y selecciona "Editar".

5. Busca la línea que dice: define('_PS_MODE_DEV_', false);

6. Cambia false por true. Debe quedar así:

define('_PS_MODE_DEV_', true);

7. Guarda los cambios.

TIP: Si no encuentras esa línea exacta, busca _PS_MODE_DEV_ con el buscador del editor. En versiones antiguas de PrestaShop, puede estar en otro archivo llamado config/config.inc.php.

Ahora, recarga tu tienda. En lugar del error genérico, verás un mensaje detallado con el archivo y la línea exacta que causa el problema. Anota ese mensaje porque te será muy útil para los siguientes pasos.

Paso 2: Verifica los permisos de archivos y carpetas

Uno de los causantes más comunes del error 500 prestashop plesk son los permisos incorrectos. Después de una actualización o migración, los archivos pueden quedar con permisos restrictivos que impiden que el servidor los lea o escriba.

Permisos correctos para PrestaShop

• Carpetas: Deben tener permisos 755 (lectura, escritura y ejecución para el propietario; lectura y ejecución para el resto).

• Archivos: Deben tener permisos 644 (lectura y escritura para el propietario; solo lectura para el resto).

Cómo corregir permisos en Plesk

1. En el Administrador de archivos, selecciona todos los archivos y carpetas de la raíz.

2. Haz clic en el botón "Permisos" (o "Cambiar permisos").

3. Aplica los permisos mencionados anteriormente.

4. Asegúrate de que la casilla "Aplicar a subdirectorios" esté marcada.

WARNING: No cambies los permisos de la carpeta var/cache si PrestaShop está en modo debug. Puede generar errores adicionales. Si tienes problemas, primero restaura los permisos originales.

Paso 3: Limpia la caché de PrestaShop

La caché corrupta es otro culpable frecuente del prestashop internal server error. PrestaShop guarda archivos temporales en la carpeta var/cache (o cache en versiones antiguas). Si estos archivos se corrompen, el servidor puede devolver un error 500.

Limpieza manual de caché

1. Ve al Administrador de archivos en Plesk.

2. Navega hasta la carpeta var/cache (si no existe, busca cache o var/cache/prod).

3. Elimina todos los archivos y subcarpetas dentro de esta carpeta. No elimines la carpeta en sí.

4. Si no puedes eliminar algún archivo, cambia sus permisos a 777 temporalmente, elimina y luego vuelve a poner 755.

TIP: En algunos casos, también es útil eliminar el archivo .htaccess en la raíz y generar uno nuevo desde el panel de administración de PrestaShop (Parámetros avanzados > Rendimiento > "Generar archivo .htaccess").

Paso 4: Revisa los logs del servidor en Plesk

Si el modo debug no te dio suficiente información, los logs del servidor son tu siguiente recurso. Plesk guarda registros detallados de todos los errores que ocurren en tu sitio.

Cómo acceder a los logs en Plesk

1. En el panel de Plesk, ve a la sección "Registros" o "Logs" (dependiendo de la versión).

2. Busca el archivo error_log o error.log correspondiente a tu dominio.

3. Abre el archivo y busca las últimas entradas. Presta especial atención a las líneas que contengan "PHP Fatal error" o "500 Internal Server Error".

INFO: Los logs pueden ser extensos. Usa el buscador del navegador (Ctrl+F) para buscar términos como "prestashop", "fatal" o "error". Esto te llevará directamente al problema.

Paso 5: Aumenta el límite de memoria PHP

Si tu tienda está creciendo y tiene muchos productos o módulos, es posible que se esté quedando sin memoria. Esto genera un prestashop plesk error muy común.

Cómo aumentar la memoria PHP en Plesk

1. En Plesk, ve a la sección "Hosting y DNS" > "Configuración de PHP" (o "PHP Settings").

2. Busca la opción "memory_limit".

3. Cámbiala a al menos 256M (256 megabytes). Si tu tienda es grande, puedes poner 512M o incluso 1G.

4. Guarda los cambios y reinicia PHP si es necesario.

WARNING: Aumentar demasiado la memoria puede afectar el rendimiento del servidor si compartes hosting con otros sitios. Empieza con 256M y ve subiendo si el problema persiste.

Paso 6: Actualiza los módulos y el núcleo de PrestaShop

Los módulos desactualizados son una fuente inagotable de errores. Un módulo incompatible con tu versión de PrestaShop puede provocar un solucion error 500 prestashop en cualquier momento.

Qué hacer si un módulo causa el error

1. Accede al panel de administración de PrestaShop (/admin).

2. Ve a la sección "Módulos" > "Módulos y servicios".

3. Revisa si hay actualizaciones disponibles. Actualiza todos los módulos que tengan una versión nueva.

4. Si el error apareció después de instalar un módulo específico, desactívalo o desinstálalo temporalmente para confirmar que es el culpable.

TIP: Si no puedes acceder al panel de administración debido al error, renombra la carpeta del módulo sospechoso desde el Administrador de archivos de Plesk. Por ejemplo, si el módulo se llama paypal, renómbralo a paypal_backup. Esto lo desactivará automáticamente.

Paso 7: Verifica la versión de PHP

PrestaShop necesita una versión específica de PHP para funcionar correctamente. Si tu servidor actualizó PHP automáticamente y tu versión de PrestaShop es antigua, es muy probable que aparezca el error 500 prestashop plesk.

Versiones compatibles de PrestaShop y PHP

• PrestaShop 1.7.x: Requiere PHP 5.6 o superior (recomendado PHP 7.x).

• PrestaShop 1.6.x: Funciona con PHP 5.3 a 5.6. No es compatible con PHP 7+ sin modificaciones.

• PrestaShop 8.x: Requiere PHP 7.2 o superior.

Cómo cambiar la versión de PHP en Plesk

1. Ve a "Hosting y DNS" > "Configuración de PHP".

2. Selecciona la versión de PHP que sea compatible con tu PrestaShop.

3. Guarda los cambios.

WARNING: Si cambias la versión de PHP, algunos módulos pueden dejar de funcionar. Asegúrate de que todos tus módulos sean compatibles con la nueva versión antes de hacer el cambio.

Paso 8: Revisa el archivo .htaccess

Un archivo .htaccess corrupto o mal configurado puede causar el prestashop internal server error. Este archivo controla el reescritura de URLs y otras configuraciones importantes.

Cómo reparar el .htaccess

1. En el Administrador de archivos, navega a la raíz de tu instalación.

2. Busca el archivo .htaccess. Si no lo ves, activa la opción "Mostrar archivos ocultos" en la configuración del Administrador de archivos.

3. Haz una copia de seguridad del archivo actual (cámbiale el nombre a .htaccess_backup).

4. Accede a tu panel de administración de PrestaShop (si puedes) y ve a "Parámetros avanzados" > "Rendimiento".

5. Haz clic en "Generar archivo .htaccess".

6. Si no puedes acceder al panel, crea un archivo .htaccess nuevo y vacío, y luego prueba si el error desaparece.

WARNING: No elimines el .htaccess sin generar uno nuevo. PrestaShop depende de él para muchas funciones, y sin él podrías tener problemas de URLs amigables y seguridad.

Paso 9: Comprueba el espacio en disco

Un disco lleno puede provocar que el servidor no pueda escribir archivos temporales, generando un prestashop plesk error.

Cómo verificar el espacio en Plesk

1. En el panel principal de Plesk, busca la sección "Estadísticas" o "Uso de disco".

2. Verifica que no estés al 100% de capacidad.

3. Si estás cerca del límite, elimina archivos temporales, copias de seguridad antiguas o logs innecesarios.

TIP: La carpeta var/logs de PrestaShop puede crecer mucho con el tiempo. Elimina los archivos de log antiguos que ya no necesites.

Paso 10: Reinstala o repara el núcleo de PrestaShop

Si has probado todo lo anterior y el error 500 prestashop plesk persiste, puede ser que algunos archivos del núcleo estén dañados. En este caso, la solución más efectiva es reinstalar los archivos del núcleo sin perder tus datos.

Cómo reparar el núcleo de PrestaShop

1. Descarga la misma versión de PrestaShop que tienes instalada desde el sitio oficial.

2. Descomprime el archivo en tu ordenador.

3. Con el Administrador de archivos de Plesk, sube solo la carpeta admin (renombrada como admin_anterior) y los archivos de la raíz, excepto la carpeta config, var y img.

4. Sobrescribe los archivos existentes cuando te lo pida.

5. Borra la carpeta var/cache de nuevo.

INFO: Este proceso no afecta a tu base de datos ni a tus productos. Solo reemplaza los archivos del programa, que es donde suele estar el problema.

Preguntas frecuentes sobre el error 500 en PrestaShop y Plesk

¿Puedo perder mis datos si sigo estos pasos?

No, siempre que no borres la base de datos. Todos los pasos anteriores son seguros y no afectan a tus productos, clientes o pedidos. Eso sí, haz siempre una copia de seguridad antes de empezar.

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

Si el error aparece solo en ciertas páginas, suele ser por un módulo específico o por una plantilla (tema) con errores. Prueba a cambiar temporalmente a un tema de PrestaShop por defecto para descartar esto.

¿Cuánto tiempo se tarda en solucionar?

La mayoría de los casos se resuelven en menos de 30 minutos. Los problemas más complejos, como archivos corruptos, pueden llevar un par de horas. Si llevas más de un día, considera contactar con tu proveedor de hosting.

¿Es necesario tener conocimientos técnicos?

No, esta guía está pensada para que cualquier persona pueda seguirla. Si te pierdes en algún paso, vuelve al anterior y verifica que todo esté correcto. Y recuerda: siempre puedes pedir ayuda al soporte de tu hosting.

¿Puede ser un problema del servidor de Plesk?

Sí, en algunos casos el error puede venir del propio servidor (por ejemplo, por una actualización fallida o un problema con el servicio de PHP). Si has probado todos los pasos y nada funciona, contacta con tu proveedor de hosting y diles que has seguido esta guía sin éxito.

Resumen rápido: checklist para resolver el error 500

Para que no te pierdas, aquí tienes un resumen de todos los pasos en orden de prioridad:

1. Activar el modo debug para ver el error exacto.

2. Verificar y corregir los permisos de archivos y carpetas.

3. Limpiar la caché de PrestaShop.

4. Revisar los logs del servidor en Plesk.

5. Aumentar el límite de memoria PHP.

6. Actualizar módulos y núcleo.

7. Verificar la versión de PHP.

8. Reparar el archivo .htaccess.

9. Comprobar el espacio en disco.

10. Reinstalar los archivos del núcleo.

TIP FINAL: Después de cada cambio, recarga tu tienda para ver si el error desaparece. Así sabrás cuál era el problema exacto y podrás evitarlo en el futuro. Y recuerda documentar siempre los cambios que haces, por si necesitas revertirlos más adelante.

Con esta guía, el error 500 prestashop plesk no debería darte más dolores de cabeza. Tómate tu tiempo, sigue los pasos con calma y verás cómo tu tienda vuelve a funcionar en poco tiempo. ¡Mucha suerte con tu negocio online!