Solucionar error 500 en PrestaShop: cPanel y DirectAdmin

¿Por qué aparece el error 500 en PrestaShop?

El error 500 prestashop es uno de los problemas más temidos por los dueños de tiendas online. Básicamente, significa que algo falló en el servidor, pero no te dice exactamente qué. Es como si el motor de tu coche se parara en medio de la carretera sin encender el testigo del aceite: sabes que algo pasa, pero no sabes por dónde empezar a mirar.

La buena noticia es que la mayoría de las veces tiene solución y no necesitas ser un experto en programación para arreglarlo. En esta guía te voy a enseñar paso a paso cómo solucionar error 500 prestashop tanto si usas DirectAdmin como si usas cPanel, que son los dos paneles de control más habituales en el hosting.

Antes de empezar, ten claro que el error 500 puede venir de muchas causas: un archivo con permisos incorrectos, un módulo que da problemas, un archivo .htaccess corrupto, o incluso un límite de memoria agotado. Vamos a ir descartando una por una.

Primeros pasos: identifica el origen del error

Cuando aparece el error 500, lo primero que debes hacer es intentar averiguar qué lo está provocando. No te lances a borrar archivos sin más, porque podrías empeorar las cosas.

Revisa si el error es general o solo en algunas páginas

Entra en tu tienda y prueba a navegar por varias secciones: la portada, una categoría, una ficha de producto y el panel de administración. Si el error aparece solo al acceder al admin, el problema suele estar en los archivos de configuración o en algún módulo recién instalado. Si falla toda la tienda, el problema es más global.

Activa el modo debug de PrestaShop

PrestaShop tiene un modo de depuración que te muestra el error concreto en pantalla. Para activarlo, necesitas editar el archivo config/defines.inc.php que encontrarás en la raíz de tu instalación.

Accede a tu hosting mediante FTP o al administrador de archivos de tu panel.
Busca la carpeta config y dentro el archivo defines.inc.php.
Ábrelo con un editor de texto (nunca con el bloc de notas de Windows, mejor uno como Notepad++).
Busca la línea que pone define('_PS_MODE_DEV_', false);
Cámbiala a define('_PS_MODE_DEV_', true);
Guarda el archivo y sube los cambios.

Ahora recarga tu tienda. En lugar del error 500 genérico, verás un mensaje específico como "Fatal error: Allowed memory size exhausted" o "Class not found". Anota ese mensaje porque te dará pistas muy valiosas.

[WARNING] No olvides volver a poner false cuando termines de arreglar el problema. Si lo dejas activado, cualquier cliente podrá ver errores internos de tu servidor, lo cual es un riesgo de seguridad.

Soluciones específicas para el error 500 en DirectAdmin

Si tu hosting usa DirectAdmin, estos son los pasos que debes seguir. DirectAdmin es menos conocido que cPanel, pero tiene herramientas muy potentes.

Restablece los permisos de archivos y carpetas

La causa más común del prestashop error 500 directadmin es que los permisos de archivos se han cambiado por error. PrestaShop necesita permisos específicos para funcionar:

Archivos: 644
Carpetas: 755
Carpetas de caché y archivos generados: 755 o 777 dependiendo del servidor

Para restablecerlos desde DirectAdmin:

Entra en el Administrador de archivos de tu cuenta.
Navega hasta la carpeta donde está instalado PrestaShop.
Selecciona todos los archivos y carpetas (Ctrl+A o Cmd+A).
Haz clic en "Cambiar permisos" o "Chmod".
Introduce 755 para carpetas y 644 para archivos.
Aplica los cambios.

Si no puedes hacerlo desde el panel, puedes conectarte por SSH y ejecutar estos comandos:

find /ruta/a/tu/prestashop -type d -exec chmod 755 {} \;
find /ruta/a/tu/prestashop -type f -exec chmod 644 {} \;

[INFO] Después de cambiar permisos, borra la carpeta var/cache (o cache en versiones antiguas) para que PrestaShop regenere los archivos temporales.

Revisa el límite de memoria PHP

DirectAdmin a veces tiene un límite de memoria PHP bastante bajo por defecto. PrestaShop necesita al menos 128 MB para funcionar con soltura, y si tienes muchos módulos, mejor 256 MB o incluso 512 MB.

Para aumentarlo:

Ve a tu cuenta de DirectAdmin.
Busca la sección Configuración de PHP o PHP Settings.
Cambia el valor de memory_limit a 256M o 512M.
Guarda los cambios y reinicia PHP si te lo pide.

Si no encuentras esa opción, puedes crear un archivo .user.ini en la raíz de tu PrestaShop con este contenido:

memory_limit = 512M
max_execution_time = 300

Soluciones específicas para el error 500 en cPanel

El prestashop error 500 cpanel suele tener causas parecidas, pero la forma de acceder a las herramientas cambia. Vamos a verlo.

Revisa el error log desde cPanel

cPanel tiene un visor de errores muy útil que te ahorrará mucho tiempo:

Entra en cPanel.
Busca la sección Métricas o Registros y haz clic en Error Log o Visor de errores.
Busca las últimas entradas que coincidan con la hora en que apareció el error 500.
Anota los mensajes: te dirán exactamente qué archivo está fallando.

Comprueba el archivo .htaccess

El archivo .htaccess de PrestaShop es delicado. Si se corrompe, provoca un error 500 inmediato. La solución más rápida es regenerarlo:

Entra al Administrador de archivos de cPanel.
Muestra los archivos ocultos (hay un botón para ello en la esquina superior derecha).
Busca el archivo .htaccess en la raíz de tu PrestaShop.
Renombra a .htaccess.bak (así lo guardas por si acaso).
Ve a tu panel de administración de PrestaShop: tu-tienda.com/admin.
Entra en Parámetros avanzados → Rendimiento.
Haz clic en "Regenerar el archivo .htaccess".

Si no tienes acceso al admin, puedes crear un archivo .htaccess nuevo con el siguiente contenido básico:

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^(.*)$ /index.php [QSA,L]
</IfModule>

[WARNING] Esta versión básica solo te servirá para que la tienda cargue, pero perderás las URLs amigables. Tendrás que regenerar el .htaccess completo desde el admin cuando consigas acceder.

Aumenta la memoria PHP desde MultiPHP INI Editor

cPanel tiene una herramienta específica para esto:

Ve a Software → MultiPHP INI Editor.
Selecciona tu dominio.
Cambia memory_limit a 512M.
Guarda los cambios.

Si no tienes esa opción, busca Select PHP Version y luego haz clic en el botón de opciones o "Switch to PHP Options".

Soluciones comunes para ambos paneles

Hay problemas que son iguales en DirectAdmin y cPanel. Vamos a verlos.

Borra la caché de PrestaShop

Una caché corrupta es culpable del error 500 en muchísimas ocasiones. Para borrarla:

Conéctate por FTP o usa el administrador de archivos.
Navega hasta la carpeta var/cache (en PrestaShop 1.7+) o cache (en 1.6).
Borra todo el contenido de la carpeta cache y también la carpeta dev si existe.
No borres la carpeta en sí, solo su contenido.

Desactiva módulos problemáticos

Si el error empezó después de instalar o actualizar un módulo, ese es el culpable. Para desactivar todos los módulos de golpe:

Entra a tu base de datos desde phpMyAdmin (disponible tanto en DirectAdmin como en cPanel).
Selecciona la base de datos de tu PrestaShop.
Abre la tabla ps_module (el prefijo puede variar si lo cambiaste al instalar).
Ejecuta esta consulta SQL:

UPDATE ps_module SET active = 0;

Recarga tu tienda. Si funciona, reactiva los módulos uno a uno desde el admin para encontrar al culpable.

[TIP] Este truco es de oro. Te evita tener que ir módulo por módulo desactivando desde el panel, que muchas veces ni siquiera carga.

Comprueba los archivos de PrestaShop

A veces el error 500 viene de un archivo dañado o incompleto. Si tienes una copia de seguridad reciente, puedes comparar:

Descarga tu copia de seguridad.
Sube los archivos de la copia encima de los actuales (solo archivos, no la base de datos).
Si no tienes copia, puedes descargar la versión exacta de PrestaShop que tienes desde el sitio oficial y reemplazar los archivos del núcleo (carpetas src, classes, vendor en versiones modernas).

Verifica los permisos de las carpetas de uploads

Las carpetas donde PrestaShop guarda las imágenes y archivos subidos a veces tienen permisos demasiado restrictivos. Asegúrate de que estas carpetas tengan permisos 755 como mínimo:

/img
/upload
/var/logs
/var/cache

Si tu servidor usa PHP como módulo de Apache (mod_php), es posible que necesites permisos 775 o incluso 777 en algunas carpetas. Pregunta a tu proveedor de hosting si no estás seguro.

Factores adicionales que debes revisar

El archivo settings.inc.php o parameters.php

PrestaShop guarda la configuración de conexión a la base de datos en estos archivos. Si se corrompen, el error 500 es inmediato.

En PrestaShop 1.6: config/settings.inc.php
En PrestaShop 1.7+: app/config/parameters.php

Abre el archivo y verifica que la contraseña, el usuario y el nombre de la base de datos sean correctos. Si cambiaste la contraseña de MySQL recientemente, este es el lugar donde debes actualizarla.

Conflictos con PHP 8.0 o versiones superiores

PrestaShop 1.6 y versiones antiguas de 1.7 no son compatibles con PHP 8.0 o superior. Si tu hosting actualizó PHP automáticamente, es muy probable que ese sea el origen del error.

En cPanel: Ve a Software → Select PHP Version y cambia a PHP 7.4 o 7.3.

En DirectAdmin: Ve a Configuración de PHP o PHP Version y selecciona la versión 7.4.

[INFO] La versión oficialmente recomendada para PrestaShop 1.7.8 y anteriores es PHP 7.2 o 7.4. Para PrestaShop 8, puedes usar PHP 8.0 o 8.1 con precaución.

Espacio en disco lleno

Si tu disco duro está lleno, el servidor no puede escribir archivos temporales y da error 500. Revisa el uso de disco en tu panel de control. Si está al 95% o más, limpia archivos temporales, logs antiguos o copias de seguridad que ya no necesites.

Herramientas de diagnóstico rápido

Para no perder tiempo, usa estas herramientas:

Herramienta	Qué hace	Dónde encontrarla
Error Log	Muestra los errores exactos del servidor	DirectAdmin: "Error Log" en tu cuenta. cPanel: "Error Log" en Métricas
Modo debug	Muestra el error en pantalla	Editando `config/defines.inc.php`
phpMyAdmin	Acceso a la base de datos	DirectAdmin: "MySQL Management". cPanel: "phpMyAdmin"
Administrador de archivos	Editar y subir archivos	Ambos paneles lo tienen

Prevención: cómo evitar que vuelva a pasar

Una vez que hayas conseguido solucionar error 500 prestashop, toma estas precauciones:

Haz copias de seguridad semanales de archivos y base de datos. La mayoría de los hostings ofrecen copias automáticas, pero no confíes solo en eso.
Actualiza PrestaShop y los módulos con regularidad. Las versiones antiguas tienen más bugs y problemas de compatibilidad.
No instales módulos piratas ni de fuentes desconocidas. Son la principal causa de errores 500.
Mantén el límite de memoria PHP alto (256 MB o más) para que la tienda no se quede corta.
Revisa los logs una vez al mes para detectar problemas antes de que se conviertan en errores visibles.

Preguntas frecuentes sobre el error 500 en PrestaShop

¿Puedo perder mis datos si borro la caché?

No. La caché solo contiene archivos temporales que PrestaShop regenera automáticamente. Tus productos, pedidos y clientes están en la base de datos, que no se toca.

¿Qué hago si ninguna de estas soluciones funciona?

Si has probado todo y el error persiste, contacta con tu proveedor de hosting. Es posible que el problema esté en el servidor y no en tu tienda. Diles que tienes un error 500 y que necesitas que revisen los logs del servidor.

¿El error 500 puede ser por un ataque de hackers?

Sí, es posible. Si detectas archivos extraños en tu instalación o el error apareció de repente sin que hicieras cambios, haz un escaneo de seguridad. PrestaShop tiene módulos de seguridad, y tu hosting puede tener herramientas de análisis de malware.

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

Depende de la causa. Si es un problema de permisos, en 10 minutos lo tienes. Si es un módulo conflictivo, puede llevarte una hora. Si es un problema del servidor, tendrás que esperar a tu proveedor.

Resumen final

El error 500 prestashop es un problema común pero solucionable. La clave está en diagnosticar bien antes de tocar nada. Recuerda el orden lógico:

Activa el modo debug para ver el error concreto.
Revisa los logs del servidor.
Comprueba permisos de archivos.
Borra la caché.
Desactiva módulos si es necesario.
Aumenta la memoria PHP.
Regenera el .htaccess.

Con esta guía, tanto si usas DirectAdmin como si usas cPanel, tendrás las herramientas necesarias para resolver el problema por ti mismo. Y si te quedas atascado, no dudes en pedir ayuda a tu hosting o a la comunidad de PrestaShop, que es muy activa y siempre hay alguien dispuesto a echar una mano.

[TIP] Guarda esta guía en tus favoritos. El error 500 es como los resfriados: tarde o temprano vuelve a aparecer, y tener la receta a mano te ahorrará muchos dolores de cabeza.