Error 500 en PrestaShop | Solución en cPanel, Plesk, DirectAdmin, Syspanel

¿Qué es el error 500 en PrestaShop?

El error 500 es uno de los mensajes más temidos para cualquier dueño de una tienda online. Cuando tu PrestaShop muestra la pantalla blanca con el texto "Internal Server Error" o simplemente "Error 500", significa que algo está fallando en el servidor, pero no te dice exactamente qué. Es como si el motor de tu coche se apagara sin encender ninguna luz de aviso concreta.

Este error puede aparecer de repente, después de instalar un módulo, al actualizar la tienda, al cambiar de servidor o incluso sin que hayas tocado nada. La buena noticia es que, en la mayoría de los casos, tiene solución y no has perdido tus datos. En este artículo te voy a enseñar paso a paso cómo diagnosticar y solucionar el error 500 PrestaShop en los paneles de control más comunes: cPanel, Plesk, DirectAdmin y Syspanel.

¿Por qué aparece el error 500 en PrestaShop?

Antes de lanzarnos a arreglar nada, es importante entender las causas más frecuentes. Así podrás atacar el problema directamente sin perder tiempo.

Causas más comunes

Archivo .htaccess corrupto o con directivas incompatibles: Este archivo es el director de tráfico de tu tienda. Si tiene una línea mal escrita, el servidor se bloquea.
Permisos de archivos y carpetas incorrectos: Si los permisos son demasiado restrictivos o demasiado abiertos, el servidor no puede leer o ejecutar los scripts PHP.
Límite de memoria PHP agotado: PrestaShop necesita bastante memoria, sobre todo con catálogos grandes o módulos pesados.
Módulo o tema incompatible: A veces una actualización o un módulo mal codificado provoca un fallo fatal.
Versión de PHP desactualizada o incompatible: PrestaShop es exigente con las versiones de PHP. Una versión obsoleta puede provocar errores internos.
Espacio en disco lleno: Si el servidor no tiene espacio ni para escribir un log, todo falla.
Errores en la base de datos o conexión fallida.

Primeros pasos para diagnosticar el error 500 PrestaShop

Cuando te enfrentas a este error, lo primero es no entrar en pánico. Aquí tienes una secuencia lógica de acciones para descubrir qué está pasando.

1. Activar el modo debug de PrestaShop

PrestaShop tiene un modo de depuración que muestra el error real en pantalla en lugar de la página genérica. Para activarlo, necesitas editar el archivo config/defines.inc.php que está en la raíz de tu instalación.

Accede a tu panel de control (cPanel, Plesk, DirectAdmin o Syspanel) y abre el administrador de archivos.
Navega hasta la carpeta donde está instalado PrestaShop (normalmente public_html o httpdocs).
Busca el archivo config/defines.inc.php y ábrelo con el editor de texto.
Localiza la línea que dice define('_PS_MODE_DEV_', false); y cámbiala a define('_PS_MODE_DEV_', true);.
Guarda el archivo y recarga tu tienda.

Ahora verás un mensaje de error mucho más descriptivo. Puede que te diga algo como "Fatal error: Allowed memory size of X bytes exhausted" o "Class not found". Ese mensaje es oro puro para saber por dónde tirar.

[INFO] Anota el mensaje de error exacto. Ese texto te servirá para buscar soluciones concretas o para enviárselo a tu soporte técnico.

2. Revisar los logs del servidor

Si el modo debug no te da suficiente información, los logs del servidor son tu siguiente recurso.

En cPanel: Entra en "Métricas > Errores" o busca la sección "Log de errores" en el panel.
En Plesk: Ve a "Sitios web y dominios" y busca el icono "Logs" o "Registros".
En DirectAdmin: En la sección "Logs" del dominio, busca el archivo error.log.
En Syspanel: Entra por el puerto 2106 (recuerda que es el acceso a este panel). Busca la sección de logs del dominio o del sitio web.

Los logs suelen estar en rutas como ~/logs/error.log o en la carpeta del dominio. Busca las últimas líneas anteriores al momento en que empezó el error.

Solucionar el error 500 en PrestaShop paso a paso

Ahora que ya tienes una pista de lo que pasa, vamos a aplicar las soluciones más efectivas. Te las presento ordenadas de la más sencilla a la más compleja.

1. Corregir el archivo .htaccess

Este es el culpable número uno del .htaccess PrestaShop error 500. Si el archivo está dañado, la solución es regenerarlo.

Renombra el archivo .htaccess actual a .htaccess.bak (así lo guardas como copia de seguridad).
Ve al panel de administración de PrestaShop: Parámetros avanzados > Rendimiento.
Pulsa el botón "Regenerar el archivo .htaccess" (o "Guardar" si no ves el botón directamente).
Si no puedes acceder al panel de administración, prueba a subir un .htaccess limpio por FTP o desde el administrador de archivos.

Un .htaccess básico para PrestaShop se ve así:

# START PrestaShop
<IfModule mod_rewrite.c>
RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . - [L]
</IfModule>
# END PrestaShop

[WARNING] No copies este ejemplo tal cual para una tienda con URLs amigables avanzadas. Es solo una base. Lo ideal es regenerarlo desde el panel.

2. Revisar los permisos de archivos y carpetas

Los permisos incorrectos son otra causa muy común. La regla general en servidores Linux es:

Carpetas: Permisos 755.
Archivos: Permisos 644.
Archivos de configuración sensibles: A veces se usa 444 para protegerlos.

Para cambiarlos desde tu panel:

cPanel: Selecciona todos los archivos y carpetas en el administrador de archivos, clic derecho y elige "Cambiar permisos".
Plesk: En el administrador de archivos, clic derecho y "Cambiar permisos".
DirectAdmin: Igual que en cPanel, desde el administrador de archivos.
Syspanel: Accede por el puerto 2106, entra al administrador de archivos y modifica los permisos desde las propiedades del archivo o carpeta.

[TIP] Si tienes acceso SSH, un comando rápido sería: find /ruta/a/prestashop -type d -exec chmod 755 {} \; y luego find /ruta/a/prestashop -type f -exec chmod 644 {} \;.

3. Aumentar el límite de memoria PHP

Si el error menciona memoria agotada, esta es tu solución.

Localiza el archivo php.ini de tu servidor (en cPanel suele estar en Public_html/php.ini o en la raíz).
Busca la línea memory_limit y cámbiala a memory_limit = 256M o incluso 512M si tu tienda es grande.
Si no tienes acceso a php.ini, puedes crear un archivo .user.ini en la raíz de PrestaShop con el contenido memory_limit = 256M.

Otra opción es modificar el archivo config/settings.inc.php de PrestaShop, añadiendo al principio:

ini_set('memory_limit', '256M');

4. Verificar la versión de PHP

PrestaShop 1.7 y 8.x necesitan PHP 7.1 o superior (idealmente 7.4 o 8.0). Si estás en una versión antigua, el error 500 es casi seguro.

cPanel: En "Select PHP Version" (Seleccionar versión de PHP).
Plesk: En "Sitios web y dominios > PHP Settings".
DirectAdmin: En "PHP Version" o "PHP Settings".
Syspanel: Entra por el puerto 2106 y busca la sección de configuración de PHP del dominio.

Cambia a una versión compatible y guarda. Prueba de nuevo tu tienda.

5. Desactivar módulos o temas problemáticos

Si el error empezó después de instalar o actualizar un módulo, el problema está ahí.

Accede a tu panel de administración de PrestaShop (si puedes).
Ve a Módulos > Administrador de módulos.
Desactiva los módulos que hayas instalado recientemente, uno a uno, y comprueba si el error desaparece.

Si no puedes acceder al panel, tendrás que hacerlo por base de datos. Usa phpMyAdmin (disponible en cPanel, Plesk, DirectAdmin y Syspanel):

Busca la tabla ps_module (el prefijo puede variar).
Localiza el módulo sospechoso y cambia el valor de active de 1 a 0.

6. Comprobar el espacio en disco

Un disco lleno puede provocar errores extraños. Revisa el uso de espacio desde tu panel de control:

cPanel: En "Información del disco".
Plesk: En "Estadísticas del servidor".
DirectAdmin: En "Administración de archivos" o "Estadísticas".
Syspanel: En la sección de estadísticas del servidor (puerto 2106).

Si está al 100%, borra archivos temporales, copias de seguridad antiguas o logs viejos.

7. Revisar la conexión a la base de datos

A veces el error 500 esconde un problema de conexión con MySQL.

Verifica que los datos de conexión en config/settings.inc.php son correctos (servidor, usuario, contraseña y nombre de BD).
Entra en phpMyAdmin y comprueba que la base de datos responde.
Si la base de datos está corrupta, puedes repararla desde phpMyAdmin: selecciona la base de datos y en la pestaña "Operaciones" elige "Reparar tabla".

Soluciones avanzadas para casos difíciles

Si has probado todo lo anterior y el error 500 PrestaShop persiste, aquí tienes algunas alternativas más técnicas.

1. Revisar la caché de PrestaShop

Una caché corrupta puede provocar errores internos. Borra la carpeta var/cache (en PrestaShop 1.7) o cache (en versiones antiguas).

Accede por FTP o administrador de archivos.
Elimina el contenido de la carpeta var/cache (no la carpeta en sí).
Recarga la tienda.

2. Revisar los logs de PHP

Si tu servidor guarda logs de PHP, revísalos. En cPanel suelen estar en logs/ o en el directorio raíz. En Plesk, en la sección de logs. En DirectAdmin, en ~/logs/. En Syspanel, busca la sección de logs de errores (recuerda: puerto 2106).

3. Revisar la configuración de los archivos de sesión

A veces el problema está en la carpeta de sesiones. Asegúrate de que la carpeta var/sessions (o cache/sessions) tenga permisos de escritura (755 o 775) y espacio suficiente.

4. Prueba con un tema por defecto

Si el error ocurre en el front-office (la tienda visible) pero no en el panel de administración, el tema puede ser el problema. Temporalmente, cambia el tema por uno por defecto (como Classic) desde Diseño > Tema y logotipo.

5. Revisar el archivo `config/defines.inc.php` para errores de compilación

A veces, el error se debe a que PrestaShop no puede escribir en las carpetas de compilación de plantillas. Asegúrate de que la carpeta var/cache/prod o var/cache/dev tenga permisos de escritura.

Consejos finales y prevención

Una vez que hayas solucionado el error 500 PrestaShop, toma estas precauciones para que no vuelva a ocurrir:

Haz copias de seguridad periódicas de tu tienda y base de datos.
Mantén PrestaShop y los módulos actualizados.
No instales módulos de fuentes desconocidas.
Monitorea el espacio en disco y el límite de memoria.
Activa el modo debug solo cuando sea necesario y desactívalo después.

[TIP] Si no te sientes cómodo tocando archivos o configuraciones, contacta con tu proveedor de hosting. Ellos pueden revisar los logs del servidor y ayudarte a identificar el problema más rápido.

Preguntas frecuentes (FAQ)

¿El error 500 significa que he perdido mis datos?

No, en absoluto. El error 500 es un fallo del servidor, no un borrado de datos. Tus productos, clientes y pedidos siguen en la base de datos. Solo necesitas arreglar el problema de configuración o de permisos.

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

Sí, puedes hacerlo vía FTP o desde el administrador de archivos de tu panel de control. Ahí puedes modificar el .htaccess, los permisos, el defines.inc.php y borrar cachés.

¿Cuánto tiempo se tarda en solucionar?

Depende de la causa. Si es el .htaccess, en 5 minutos lo tienes. Si es un módulo conflictivo, puede llevarte media hora. Si es un problema de servidor, puede requerir la intervención de tu hosting.

¿Qué hago si nada de esto funciona?

Si has probado todos los pasos y sigues con el error, el problema puede estar en el propio servidor (configuración de Apache/Nginx, firewall, etc.). Contacta con tu proveedor de hosting y dales el mensaje de error exacto que obtuviste con el modo debug. Ellos tienen acceso a logs más profundos.

¿El error 500 tiene relación con el SEO?

Sí, y es importante solucionarlo rápido. Si el error persiste durante horas o días, Google puede penalizar tu posicionamiento porque no puede rastrear tu tienda. Una vez solucionado, verifica en Google Search Console que las páginas vuelven a indexarse correctamente.

Recuerda que la paciencia y el método son tus mejores aliados. Sigue estos pasos en orden, y casi con total seguridad darás con la solución. Si te ha sido útil, compártelo con otros dueños de tiendas PrestaShop que puedan estar pasando por el mismo problema.