Solucionar error 500 en PrestaShop: guía completa

Cuando tu tienda online muestra un error 500 PrestaShop, la sensación es de pánico total: tu negocio está caído, los clientes no pueden comprar y no sabes por dónde empezar. Pero respira. Este error, conocido como "Error interno del servidor", es uno de los más comunes en el mundo del hosting y, en la gran mayoría de los casos, tiene una solución sencilla que puedes aplicar tú mismo sin ser un experto en programación.

En esta guía extensa y práctica, te voy a enseñar paso a paso cómo solucionar error 500 en PrestaShop, tanto si tu hosting usa cPanel como si usa Plesk. Vamos a ir desde lo más básico (como borrar la caché) hasta lo más técnico (como aumentar el límite de memoria PHP), siempre con un lenguaje claro y ejemplos directos. Al final, tendrás un plan de acción completo para recuperar tu tienda.

¿Qué significa exactamente el error 500 en PrestaShop?

Antes de ponernos manos a la obra, es importante que entiendas qué está pasando. El error 500 PrestaShop es un mensaje genérico que indica que algo salió mal en el servidor, pero no te dice exactamente qué. Es como si el servidor dijera: "He intentado procesar tu solicitud, pero algo ha fallado internamente y no puedo continuar".

Las causas más frecuentes suelen ser:

Problemas de permisos de archivos o carpetas: Los archivos de tu tienda necesitan permisos específicos para ser leídos y escritos.
Errores en el archivo .htaccess: Este archivo de configuración es vital para PrestaShop y un pequeño error puede tumbar toda la tienda.
Límite de memoria PHP agotado: Si tu tienda tiene muchos productos o módulos, puede necesitar más memoria de la que tu hosting permite por defecto.
Conflictos entre módulos o temas: A veces, una actualización o una mala configuración de un módulo genera un conflicto fatal.
Versión de PHP incompatible: PrestaShop necesita una versión de PHP específica para funcionar correctamente.
Archivos corruptos o incompletos: Una actualización interrumpida o una subida de archivos fallida puede dejar archivos dañados.

Ahora sí, vamos a la acción. Sigue estos pasos en orden, ya que van de lo más simple a lo más complejo.

Paso 1: Activa el modo de depuración para ver el error real

El error 500 es como una caja negra. Para abrirla, necesitas activar el modo de depuración de PrestaShop. Esto te mostrará el error específico en pantalla, lo que te dará una pista enorme sobre la causa.

¿Cómo activar el modo debug en PrestaShop?

Accede a tu panel de control de hosting (cPanel o Plesk) y abre el Administrador de archivos.
Navega hasta la carpeta raíz de tu tienda (normalmente public_html o httpdocs).
Busca un archivo llamado config/defines.inc.php.
Haz clic derecho sobre él y selecciona Editar (o "Edit").
Busca la línea que dice define('_PS_MODE_DEV_', false);.
Cambia false por true. Debe quedar así: define('_PS_MODE_DEV_', true);.
Guarda el archivo y sube los cambios si es necesario.

Ahora, recarga tu tienda. En lugar del error 500 genérico, verás un mensaje de error detallado con la ruta del archivo problemático.

[TIP]: Anota ese mensaje de error. Te será de gran ayuda en los siguientes pasos. Si el error menciona un archivo de un módulo específico, ya sabes dónde está el problema.

Paso 2: Borra la caché de PrestaShop y del servidor

La caché es una copia temporal de tus páginas para que carguen más rápido. A veces, esa copia se corrompe y provoca el error.

Borrar caché desde el panel de administración (si puedes acceder)

Ve a tu panel de administración de PrestaShop (normalmente en /admin).
En el menú superior, ve a Parámetros avanzados > Rendimiento.
Busca la opción Borrar la caché y haz clic en el botón correspondiente (suele ser un icono de papelera o un botón azul).

Borrar caché manualmente (si no puedes acceder al panel)

Ve al Administrador de archivos de tu hosting.
Navega a la carpeta var/cache (en versiones modernas de PrestaShop) o cache (en versiones antiguas).
Dentro, verás carpetas con nombres como dev, prod o cachefs.
Elimina todo el contenido de estas carpetas, pero no borres las carpetas en sí. Es decir, selecciona todos los archivos dentro y bórralos.

Borrar caché en cPanel

En cPanel, busca la herramienta "Cache Manager" o "Optimizar sitio web". Si tu hosting usa LiteSpeed, también puedes borrar la caché desde ahí.

Borrar caché en Plesk

En Plesk, ve a "Sitios web y dominios" > tu dominio > "Apache y nginx" y busca la opción de limpiar la caché.

[WARNING]: No borres la carpeta cache entera, solo su contenido. Si borras la carpeta, PrestaShop puede tener problemas para recrearla.

Paso 3: Revisa y restaura el archivo .htaccess

El archivo .htaccess es el "guardia de seguridad" de tu tienda. Si se corrompe o tiene una regla incorrecta, el servidor falla.

Regenerar el .htaccess desde el panel de administración

Si puedes acceder al panel de administración, ve a Parámetros avanzados > Rendimiento.
Desplázate hasta la sección "Archivo .htaccess" y haz clic en el botón "Guardar" o "Regenerar". Esto creará un archivo nuevo y limpio.

Crear un .htaccess de respaldo manualmente

Si no puedes acceder al panel, sigue estos pasos:

Ve al Administrador de archivos y busca el archivo .htaccess en la raíz de tu tienda.
Renómbralo a .htaccess_bak (esto lo desactiva temporalmente).
Intenta acceder a tu tienda. Si ahora carga (aunque sea sin URL amigables), el problema era el .htaccess.
Para crear uno nuevo, ve a tu panel de administración (si puedes) y guarda la configuración de URLs amigables. Si no, puedes copiar un .htaccess básico de PrestaShop desde la documentación oficial, pero es más fácil pedirle a tu hosting que lo restaure desde una copia de seguridad.

[INFO]: Si renombras el .htaccess, las URLs de tus productos dejarán de ser amigables (aparecerán con números y ?id_product=). Esto es solo temporal mientras solucionas el error.

Paso 4: Aumenta el límite de memoria PHP

Uno de los culpables más comunes del error 500 PrestaShop es que tu tienda se queda sin memoria PHP. Esto pasa sobre todo si tienes muchos módulos activos o si tu catálogo es grande.

Aumentar memoria en cPanel

En cPanel, busca la herramienta "Select PHP Version" o "MultiPHP Manager".
Haz clic en "Opciones" o "Switch to PHP Options".
Busca la variable memory_limit y cámbiala a 256M o 512M. Te recomiendo empezar con 256M.
Guarda los cambios y reinicia PHP si te lo pide.

Aumentar memoria en Plesk

En Plesk, ve a "Sitios web y dominios" > tu dominio > "Configuración de PHP".
Busca la opción memory_limit y cámbiala a 256M o 512M.
Aplica los cambios.

Aumentar memoria editando el archivo settings.inc.php

Si tu hosting no te permite cambiar la configuración de PHP desde el panel, puedes hacerlo manualmente:

Ve al Administrador de archivos y navega a config/settings.inc.php.
Edita el archivo y busca la línea que define _PS_MEMORY_LIMIT_ (puede no existir).
Si existe, cámbiala por: define('_PS_MEMORY_LIMIT_', '256M');.
Si no existe, añade esa línea justo después de la línea que comienza con define('_DB_SERVER_').

[TIP]: Si después de esto el error persiste, prueba con 512M. Pero recuerda que aumentar demasiado la memoria puede ralentizar tu servidor si es muy limitado.

Paso 5: Verifica los permisos de archivos y carpetas

Los permisos incorrectos son otra causa clásica del error. PrestaShop necesita permisos específicos para funcionar: las carpetas deben tener 755 y los archivos 644.

Cómo corregir permisos en cPanel

En el Administrador de archivos, selecciona todos los archivos y carpetas de la raíz de tu tienda.
Haz clic en "Permisos" en la barra superior.
Cambia el permiso a 755 para carpetas y 644 para archivos. Puedes hacerlo en lote seleccionando todos y aplicando el cambio.

Cómo corregir permisos en Plesk

En el Administrador de archivos de Plesk, selecciona todo y haz clic en "Cambiar permisos".
Marca las casillas para 755 en carpetas y 644 en archivos.

[WARNING]: No pongas permisos 777 (lectura, escritura y ejecución para todos). Es un riesgo de seguridad grave. Si tu hosting te lo pide para alguna carpeta temporal, cámbialo de vuelta a 755 después de solucionar el error.

Paso 6: Revisa la versión de PHP

PrestaShop es muy sensible a la versión de PHP. Una versión demasiado nueva o demasiado antigua puede generar conflictos.

Versiones recomendadas de PHP para PrestaShop

PrestaShop 1.7 y 8.x: PHP 7.2 a 8.1 (idealmente 7.4 o superior).
PrestaShop 1.6: PHP 5.6 a 7.1 (no uses PHP 8 con 1.6).

Cambiar la versión de PHP en cPanel

Ve a "Select PHP Version".
En el menú desplegable, elige la versión recomendada para tu PrestaShop.
Haz clic en "Set as current" y guarda.

Cambiar la versión de PHP en Plesk

Ve a "Sitios web y dominios" > tu dominio > "Configuración de PHP".
En la parte superior, cambia la versión de PHP.
Aplica los cambios.

[INFO]: Si no sabes qué versión de PrestaShop tienes, mira el archivo config/settings.inc.php y busca la constante _PS_VERSION_. También puedes verlo en el panel de administración.

Paso 7: Desactiva módulos o temas problemáticos

Si el error apareció después de instalar o actualizar un módulo, ese es el principal sospechoso. Puedes desactivarlo manualmente renombrando su carpeta.

Desactivar un módulo manualmente

Ve al Administrador de archivos.
Navega a la carpeta modules.
Busca la carpeta del módulo que crees que causa el problema (por ejemplo, blockwishlist).
Renómbrala añadiendo un guion bajo al final, por ejemplo: blockwishlist_. Esto desactiva el módulo sin borrarlo.
Recarga tu tienda.

Si la tienda carga, has encontrado al culpable. Ahora puedes decidir si actualizar el módulo, contactar con su desarrollador o eliminarlo.

Desactivar el tema

Si el problema es el tema, puedes cambiar temporalmente al tema por defecto:

Navega a la carpeta themes.
Renombra la carpeta de tu tema activo (por ejemplo, classic a classic_bak).
Si tienes otro tema, actívalo. Si no, PrestaShop usará el tema por defecto.

[TIP]: Anota qué módulo o tema has desactivado. Después de solucionar el error, puedes reactivarlos uno a uno para confirmar cuál era el problema.

Paso 8: Solución avanzada: revisa los logs del servidor

Si has llegado hasta aquí y el error persiste, necesitas ver los registros del servidor. Son como el "diario de a bordo" que te dice exactamente qué falla.

Ver logs en cPanel

En cPanel, busca la herramienta "Errores" o "Error Log".
Revisa las últimas líneas con la fecha y hora en que ocurrió el error.
Busca palabras clave como PHP Fatal error, Memory exhausted o Parse error.

Ver logs en Plesk

Ve a "Sitios web y dominios" > tu dominio > "Registros" o "Logs".
Filtra por fecha y hora.
Busca errores críticos.

[WARNING]: Los logs pueden ser muy técnicos. Si ves un error que no entiendes, busca el texto exacto en Google. La comunidad de PrestaShop es enorme y seguro que alguien ha tenido el mismo problema.

Paso 9: Verifica el espacio en disco y la cuota

Un disco lleno puede provocar errores extraños, incluido el 500. Si tu hosting tiene una cuota de espacio, y está al 100%, el servidor no puede escribir archivos temporales y falla.

En cPanel, ve a "Uso de disco" o "Información de la cuenta".
En Plesk, ve a "Sitios web y dominios" > tu dominio > "Uso del disco".
Si está casi lleno, borra archivos temporales, copias de seguridad antiguas o logs viejos.

Paso 10: Restaura una copia de seguridad reciente

Si nada de lo anterior funciona, la solución más rápida (aunque menos elegante) es restaurar una copia de seguridad reciente de tu tienda. Esto deshará cualquier cambio reciente que haya causado el error.

Restaurar desde cPanel

Ve a "Copias de seguridad" > "Restaurar una copia de seguridad de un directorio".
Selecciona la copia más reciente y restaura.

Restaurar desde Plesk

Ve a "Sitios web y dominios" > tu dominio > "Copias de seguridad".
Elige la copia y haz clic en "Restaurar".

[INFO]: Asegúrate de hacer una copia de tu base de datos antes de restaurar, por si acaso. La restauración de archivos no suele tocar la base de datos, pero es mejor prevenir.

Preguntas Frecuentes (FAQ)

¿El error 500 puede ser culpa del hosting?

Sí, a veces el problema es del servidor en sí. Si tu hosting tiene una sobrecarga o un fallo en el servidor web, puede dar errores 500 a todos los sitios. Contacta con tu proveedor de hosting para confirmar.

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

Sí, todos los pasos que te he mostrado (excepto el paso 2 de borrar caché desde el panel) se pueden hacer desde el Administrador de archivos de cPanel o Plesk.

¿Cuánto tiempo se tarda en arreglar el error 500?

Depende de la causa. Si es solo la caché, en 5 minutos. Si es un módulo conflictivo, puede llevarte 30 minutos. Si es un problema más profundo, quizás necesites ayuda profesional.

¿Qué hago si mi hosting usa Syspanel (HestiaCP)?

Si tu hosting usa Syspanel (el panel que antes se llamaba HestiaCP), el acceso se realiza por el puerto 2106 (por ejemplo, `https://tu-s