Solucionar el error 500 en PrestaShop: Guía completa

¿Qué significa el error 500 en PrestaShop?

El error 500 prestashop es un mensaje genérico que indica que algo falló internamente en el servidor, pero no te dice exactamente qué. Es como si el servidor dijera "algo se rompió, pero no te voy a dar más detalles". Para un usuario sin experiencia técnica, ver este error en la tienda puede ser desesperante, sobre todo si los clientes ya están intentando comprar.

La buena noticia es que, en la mayoría de los casos, solucionar error 500 prestashop es cuestión de revisar unos pocos archivos y permisos. Y lo mejor: no necesitas ser un programador experto. Con seguir estos pasos, podrás recuperar tu tienda en pocos minutos.

Antes de empezar: prepara tu entorno de trabajo

Para trabajar con tranquilidad, necesitas acceso a dos cosas:

El panel de control de tu hosting (Plesk, DirectAdmin o cPanel).
Un gestor de archivos (puede ser el del propio panel o un cliente FTP como FileZilla).

Si no tienes claro qué panel usa tu hosting, mira el correo de bienvenida que te enviaron al contratar el servicio. Allí suele venir la URL de acceso.

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el acceso se realiza por el puerto 2106. Por ejemplo: https://tu-dominio.com:2106. El proceso es similar al de los otros paneles, pero con esa particularidad en la URL.

Paso 1: Activa el modo de depuración de PrestaShop

El primer paso para solucionar error 500 prestashop es hacer que el sistema te muestre el error real. Por defecto, PrestaShop lo oculta por seguridad, pero puedes activarlo temporalmente.

Cómo activar el modo debug

Entra a tu panel de hosting y abre el Administrador de archivos.
Navega hasta la carpeta raíz de tu tienda (normalmente public_html, www o htdocs).
Busca el archivo llamado config/defines.inc.php.
Ábrelo con el editor de texto del panel (clic derecho → Editar).
Busca esta línea:

define('_PS_MODE_DEV_', false);

Cámbiala por:

define('_PS_MODE_DEV_', true);

Guarda el archivo y recarga tu tienda.

Ahora verás el error real en pantalla, con un mensaje como "Fatal error: ..." o "Parse error: ...". Anota ese mensaje, porque te indicará exactamente qué archivo está fallando.

[WARNING] No olvides volver a poner false cuando termines de arreglar el error. Dejarlo en true en producción es un riesgo de seguridad grave.

Paso 2: Revisa los permisos de archivos y carpetas

Una causa muy común del error 500 prestashop son los permisos incorrectos. Si después de una actualización o una migración los permisos se cambiaron, tu tienda no podrá leer o escribir los archivos necesarios.

Permisos correctos para PrestaShop

Carpetas: deben tener permiso 755.
Archivos: deben tener permiso 644.
Carpeta config y cache: pueden necesitar 755 o incluso 775 en algunos servidores.

Cómo cambiar permisos desde el panel

En el Administrador de archivos, selecciona toda la carpeta de tu tienda.
Busca la opción Permisos o Chmod (suele estar en el menú superior).
Introduce 755 para carpetas y 644 para archivos.
Marca la casilla "Aplicar a subcarpetas y archivos" si existe.

[TIP] Si usas cPanel, puedes hacer esto desde "Administrador de archivos" → seleccionar todo → "Permisos". En Plesk, es similar: botón derecho → "Permisos". En DirectAdmin, busca el icono de "Cambiar permisos".

Paso 3: Vacía la caché de PrestaShop

Otra causa típica del error 500 plesk prestashop o en cualquier otro panel es una caché corrupta. PrestaShop guarda archivos temporales en la carpeta var/cache (en versiones nuevas) o cache (en versiones antiguas).

Cómo vaciar la caché manualmente

Entra al Administrador de archivos.
Ve a la carpeta var/cache o cache (según tu versión).
Dentro de esa carpeta, borra todo el contenido (los archivos y subcarpetas que haya).
No borres la carpeta en sí, solo su contenido.
Vuelve a intentar cargar tu tienda.

[WARNING] Si no puedes borrar los archivos, puede que el servidor tenga bloqueados los permisos. Intenta cambiar los permisos de la carpeta cache a 755 y luego borra.

Paso 4: Revisa el archivo `.htaccess`

Si tu tienda usa Apache (lo normal en la mayoría de hostings), el archivo .htaccess es clave. A veces, durante una actualización o un cambio de configuración, este archivo se corrompe y provoca el error.

Cómo regenerar el `.htaccess`

En el Administrador de archivos, localiza el archivo .htaccess en la raíz de tu tienda.
Descárgalo a tu ordenador como respaldo (por si acaso).
Bórralo del servidor.
Ahora, entra al panel de administración de tu tienda (si puedes acceder).
Ve a Parámetros avanzados → Rendimiento.
Pulsa el botón "Guardar" sin cambiar nada. Esto regenerará el .htaccess automáticamente.

Si no puedes acceder al panel de administración, crea un archivo .htaccess vacío en la raíz y luego intenta entrar. PrestaShop lo regenerará solo.

[INFO] En algunos casos, el error 500 viene porque el .htaccess tiene reglas incompatibles con tu servidor. Si lo regeneras y sigue fallando, prueba a desactivar el "URL amigable" desde la base de datos (pero eso ya es más avanzado).

Paso 5: Comprueba la memoria PHP y los límites del servidor

A veces, el error 500 prestashop aparece porque el script necesita más memoria de la que tu servidor le permite. Esto es especialmente común si tienes muchos módulos o una tienda grande.

Cómo aumentar el límite de memoria

Busca el archivo php.ini en la raíz de tu hosting (si no existe, créalo).
Añade o modifica estas líneas:

memory_limit = 512M
max_execution_time = 300
max_input_time = 300

Guarda y reinicia PHP desde el panel (en cPanel es "Select PHP Version" → "Switch to PHP Options" o similar; en Plesk, "Configuración de PHP").

Si no puedes editar php.ini, también puedes añadir esto al archivo .htaccess:

php_value memory_limit 512M
php_value max_execution_time 300

[TIP] Si tu hosting usa Syspanel (puerto 2106), busca la sección de "PHP" en el panel y ajusta los valores desde allí. Es más cómodo que editar archivos.

Paso 6: Revisa los módulos y el tema

Un módulo incompatible o un tema mal configurado también pueden causar el error 500 en PrestaShop. Para descartarlo:

Entra al panel de administración (si puedes).
Ve a Módulos → Módulos instalados.
Desactiva los módulos uno a uno (empezando por los que no sean de PrestaShop).
Recarga tu tienda después de cada desactivación.

Si el error desaparece al desactivar un módulo, ya sabes cuál es el culpable. Actualízalo o contacta con su desarrollador.

[WARNING] Si no puedes acceder al panel de administración, renombra la carpeta modules a modules_backup (desde el Administrador de archivos). Esto desactiva todos los módulos temporalmente. Si la tienda carga, el problema es uno de ellos. Luego ve moviendo módulos de vuelta poco a poco.

Paso 7: Revisa los logs del servidor

Si después de todos los pasos anteriores sigues con el prestashop error 500 cpanel o en cualquier otro panel, es hora de mirar los registros del servidor. Allí estará el error exacto.

Dónde encontrar los logs

cPanel: sección "Métricas" → "Errores" o "Registros de errores".
Plesk: "Sitios web y dominios" → tu dominio → "Registros" o "Logs".
DirectAdmin: "Errores" en el menú lateral.
Syspanel (puerto 2106): busca "Registros" o "Logs" en el panel principal.

Busca la línea que coincida con la hora en que apareció el error. El mensaje técnico te dará la pista final.

[TIP] Si no entiendes el mensaje del log, cópialo y búscalo en Google. Es muy probable que otro usuario ya haya tenido el mismo problema y haya compartido la solución.

Paso 8: Verifica la base de datos

Una base de datos corrupta o con tablas dañadas también puede provocar un error 500 prestashop. Para comprobarlo:

Entra a phpMyAdmin desde tu panel de hosting.
Selecciona la base de datos de tu tienda.
En la pestaña "Operaciones" (o "Más"), busca "Verificar tablas" o "Reparar tablas".
Ejecuta la verificación y, si hay errores, repara.

[INFO] Si no sabes cuál es tu base de datos, revisa el archivo config/settings.inc.php (en versiones antiguas) o app/config/parameters.php (en versiones nuevas). Allí verás el nombre de la base de datos.

Paso 9: Reinstala los archivos de PrestaShop

Si nada de lo anterior funciona, es muy probable que algún archivo del núcleo esté corrupto o incompleto. La solución más fiable es reinstalar los archivos de PrestaShop sin tocar tu base de datos.

Cómo hacerlo

Descarga la misma versión de PrestaShop que tienes instalada desde prestashop.com.
Descomprime el archivo en tu ordenador.
Sube solo la carpeta admin (renómbrala con el nombre de tu carpeta admin actual) y las carpetas classes, controllers, src y vendor (si existen).
Sobrescribe los archivos existentes.
Borra la carpeta var/cache (o cache) y vuelve a cargar la tienda.

[WARNING] No subas el archivo config/settings.inc.php ni app/config/parameters.php de la descarga, porque eso sobreescribiría tu configuración real y romperías la conexión con la base de datos.

Paso 10: Contacta con tu proveedor de hosting

Si has llegado hasta aquí y el error 500 prestashop sigue apareciendo, puede que el problema esté fuera de tu alcance. Algunas causas comunes que dependen del hosting:

Límite de procesos o de CPU excedido.
Errores en el servidor (configuración de PHP, módulos de Apache, etc.).
Bloqueos de seguridad (mod_security, por ejemplo).

En ese caso, abre un ticket de soporte y copia el mensaje exacto del error que viste en el paso 1. Cuanta más información les des, más rápido lo resolverán.

Preguntas frecuentes (FAQ)

¿El error 500 en PrestaShop tiene que ver con el hosting?

Sí, en la mayoría de los casos sí. Puede ser por límites de memoria, permisos incorrectos, configuraciones de PHP o incluso problemas en el servidor. Pero también puede ser por un módulo o tema incompatible.

¿Puedo perder mis productos si intento arreglar el error?

No. Todos los pasos que te he explicado no tocan tu base de datos. Solo trabajas con archivos, permisos y configuración. Tu catálogo, pedidos y clientes están a salvo.

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

En la mayoría de los casos, entre 15 y 30 minutos si sigues estos pasos en orden. Los casos más complejos pueden llevar más tiempo, pero es raro.

¿Qué hago si el error aparece solo en el panel de administración?

Eso suele indicar un problema con la carpeta admin o con los permisos de los archivos de configuración. Revisa los pasos 2 y 9 específicamente.

Resumen rápido: checklist para solucionar el error 500

Para que no se te olvide nada, aquí tienes la lista rápida:

☐ Activar el modo debug para ver el error exacto.
☐ Revisar permisos de archivos y carpetas (755/644).
☐ Vaciar la caché de PrestaShop.
☐ Regenerar el archivo .htaccess.
☐ Aumentar el límite de memoria PHP.
☐ Desactivar módulos sospechosos.
☐ Revisar los logs del servidor.
☐ Verificar y reparar la base de datos.
☐ Reinstalar archivos del núcleo.
☐ Contactar con el soporte del hosting.

Con esto, tienes todas las herramientas para solucionar error 500 prestashop tanto en Plesk, DirectAdmin, cPanel como en Syspanel (recuerda, puerto 2106). Ve paso a paso, sin prisa, y casi seguro que tu tienda vuelve a estar operativa en poco tiempo. Si te surge cualquier duda, revisa la FAQ o deja un comentario y te ayudaremos. ¡Mucha suerte!