Cómo arreglar el error 500 en PrestaShop (Syspanel, cPanel, Plesk)

¿Qué significa el error 500 en PrestaShop y por qué aparece?

Cuando visitas tu tienda online y, en lugar de ver tus productos, aparece una pantalla en blanco o un mensaje genérico de "Error interno del servidor", estás ante el temido error 500 PrestaShop. Este código de estado HTTP indica que algo ha fallado en el servidor, pero no te dice exactamente qué es. Es como si tu tienda tuviera una avería interna: la fachada sigue en pie, pero el motor no arranca.

Las causas más habituales suelen ser un archivo de configuración corrupto, un módulo incompatible, problemas de permisos en los archivos, una versión de PHP desactualizada o un límite de memoria agotado. La buena noticia es que, en la mayoría de los casos, puedes arreglar error 500 PrestaShop sin necesidad de ser un experto en programación. Solo necesitas seguir una serie de pasos lógicos y tener acceso a tu panel de control o a un gestor de archivos.

Antes de empezar, es importante que sepas que este error puede aparecer tanto en el front-office (la parte visible de tu tienda) como en el back-office (el administrador). Si el error solo aparece en una zona concreta, el diagnóstico será más rápido. Si aparece en todas partes, tendrás que revisar la configuración general.

Primeros pasos: activa el modo debug de PrestaShop

La forma más rápida de saber qué está fallando es activar el modo de depuración de PrestaShop. Este modo te mostrará el error real en pantalla en lugar de la página genérica. Para ello, necesitas acceder a los archivos de tu instalación.

Accede a tu servidor mediante FTP o administrador de archivos

El método más común es usar un cliente FTP como FileZilla o el administrador de archivos que ofrece tu panel de hosting. Si tu hosting usa Syspanel (el panel de control que antes conocíamos como HestiaCP), recuerda que el acceso se realiza a través del puerto 2106. Por ejemplo, si tu dominio es tutienda.com, la URL de acceso sería https://tutienda.com:2106. Una vez dentro, busca la sección de "Administrador de archivos" o "Gestor de archivos".

Edita el archivo define.inc.php

Dentro de la carpeta config de tu instalación de PrestaShop, encontrarás un archivo llamado define.inc.php. Debes editarlo y localizar la línea que dice:

define('_PS_MODE_DEV_', false);

Cámbiala por:

define('_PS_MODE_DEV_', true);

Guarda el archivo y vuelve a cargar tu tienda. Ahora deberías ver un mensaje de error detallado con la ruta del archivo problemático y el número de línea. Anota esa información, porque te será muy útil para los siguientes pasos. Cuando termines de diagnosticar, no olvides volver a poner el valor en false para no mostrar información sensible a tus clientes.

[WARNING] No dejes el modo debug activado permanentemente en una tienda en producción. Cualquier visitante podría ver rutas internas de tu servidor, lo que supone un riesgo de seguridad.

Causa común #1: Permisos de archivos incorrectos

Una de las causas más frecuentes del error 500 PrestaShop es que los archivos o carpetas tengan permisos demasiado restrictivos o demasiado permisivos. PrestaShop necesita que ciertos archivos sean escribibles para generar caché, subir imágenes o actualizar módulos.

Permisos recomendados

Carpetas: 755
Archivos: 644
Carpetas de caché (var/cache o cache): 755

Para cambiarlos desde Syspanel, entra al administrador de archivos, selecciona todos los archivos y carpetas de tu instalación y usa la opción "Permisos" o "CHMOD". Si usas FTP, puedes hacer clic derecho sobre cada archivo y seleccionar "Permisos de archivo". Aplica los valores mencionados y prueba de nuevo tu tienda.

[TIP] Si después de cambiar los permisos sigue el error, prueba con permisos 777 temporalmente en las carpetas de caché para ver si el problema se resuelve. Luego vuelve a 755 para mayor seguridad.

Causa común #2: Límite de memoria PHP agotado

PrestaShop es una plataforma bastante exigente en cuanto a recursos. Si tu tienda tiene muchos módulos, productos o un tema pesado, es fácil que alcances el límite de memoria PHP por defecto (que suele ser de 128 MB o menos). Cuando esto ocurre, el servidor lanza un error fatal y se muestra el temido error 500.

Cómo aumentar el límite de memoria

Desde el archivo .htaccess (si usas Apache): añade esta línea al final:

php_value memory_limit 512M

Desde el archivo php.ini (si tienes acceso): busca la línea memory_limit y cámbiala a 512M.
Desde el panel de control: en Syspanel, busca la sección de "PHP" o "Configuración PHP". Allí podrás cambiar el valor de memory_limit desde un desplegable sin necesidad de editar archivos.

También puedes crear un archivo ini_set.php en la raíz con el siguiente contenido para comprobar el límite actual:

<?php echo ini_get('memory_limit'); ?>

Si el valor es muy bajo, ya sabes por dónde empezar.

[INFO] Un límite de memoria de 256 MB es suficiente para la mayoría de tiendas pequeñas y medianas. Si tienes una tienda grande, considera 512 MB o más.

Causa común #3: Módulos o temas incompatibles

Los módulos son la pesadilla más habitual cuando hablamos de PrestaShop error 500 solucion. Un módulo que no está actualizado, que es incompatible con tu versión de PrestaShop o que tiene un conflicto con otro módulo puede provocar un error fatal en toda la tienda.

Cómo aislar el problema

Accede al back-office (si el error te lo permite). Si puedes entrar, ve a "Módulos" > "Administrador de módulos".
Desactiva los módulos recientemente instalados o actualizados. Si el error apareció después de instalar algo nuevo, ese es el culpable probable.
Si no puedes acceder al back-office, tendrás que hacerlo manualmente. Renombra la carpeta del módulo sospechoso en el servidor. Por ejemplo, si el módulo se llama mimodulo, cámbiala a mimodulo_backup. PrestaShop lo detectará como desinstalado y debería cargar la tienda.

Los temas también pueden causar problemas. Prueba a cambiar temporalmente al tema predeterminado de PrestaShop para descartar que tu tema personalizado sea el origen del fallo.

[WARNING] Antes de tocar módulos o temas, haz siempre una copia de seguridad de los archivos y la base de datos. Así podrás revertir cualquier cambio si algo sale mal.

Causa común #4: Versión de PHP incompatible

PrestaShop tiene requisitos específicos de versión de PHP. Si tu hosting ha actualizado PHP automáticamente o si tienes una versión demasiado antigua, es probable que aparezca el error 500 PrestaShop. Por ejemplo, PrestaShop 1.7 funciona mejor con PHP 7.x, mientras que versiones más recientes ya soportan PHP 8.x.

Cómo cambiar la versión de PHP desde Syspanel

En Syspanel, ve a la sección de "Web" o "Dominios", selecciona tu dominio y busca la opción "PHP" o "Versión de PHP". Allí podrás elegir la versión que necesites entre las disponibles. Te recomiendo probar con la versión recomendada por tu versión de PrestaShop.

Si no tienes claro qué versión usar, consulta la documentación oficial o el archivo composer.json de tu instalación. También puedes crear un archivo info.php con <?php phpinfo(); ?> para ver la versión actual y los módulos cargados.

[TIP] Si tu hosting te da la opción de elegir entre PHP 7.4 y PHP 8.0, prueba primero con 7.4 si tienes una tienda antigua. Las versiones más nuevas pueden tener incompatibilidades con módulos antiguos.

Causa común #5: Archivos .htaccess corruptos

El archivo .htaccess de PrestaShop controla las redirecciones, el acceso a ciertas carpetas y la configuración de caché. Si este archivo se corrompe o tiene reglas incorrectas, puede generar un error 500.

Cómo regenerar el .htaccess

Renombra el archivo actual a .htaccess_backup.
Accede al back-office (si puedes) o espera unos segundos. PrestaShop generará un nuevo .htaccess automáticamente al cargar la tienda.
Si no se genera, puedes crear uno manualmente con el contenido básico que PrestaShop suele usar. Pero lo más sencillo es probar primero con el backup.

Si el error se soluciona al renombrar el archivo, el problema era una regla específica de tu .htaccess. Revisa las líneas relacionadas con redirecciones o módulos de SEO.

[WARNING] No borres el archivo .htaccess sin hacer copia. Si lo pierdes, tu tienda podría perder las URLs amigables y las redirecciones.

Causa común #6: Base de datos corrupta o con errores

Aunque menos frecuente, un problema en la base de datos también puede manifestarse como un error 500. Esto puede pasar después de una importación fallida, una actualización interrumpida o un ataque malintencionado.

Cómo comprobar la base de datos

Desde Syspanel: busca la sección de "Bases de datos". Allí podrás ver si la base de datos está activa y su tamaño.
Usa una herramienta como phpMyAdmin (si tu panel lo ofrece) para ejecutar un CHECK TABLE en las tablas principales de PrestaShop.

Si encuentras errores, puedes intentar reparar las tablas con REPAIR TABLE. También puedes hacer una copia de seguridad e importarla de nuevo, pero esto es más avanzado.

[INFO] Si no te sientes cómodo trabajando con bases de datos, contacta con tu proveedor de hosting y pide que verifiquen la integridad de la base de datos de tu tienda.

Prevención: cómo evitar futuros errores 500

Una vez que hayas arreglado error 500 PrestaShop, es buena idea tomar medidas para que no vuelva a aparecer.

Buenas prácticas

Mantén PrestaShop, los módulos y los temas siempre actualizados.
Haz copias de seguridad periódicas de archivos y base de datos.
Activa el modo mantenimiento cuando vayas a hacer cambios importantes.
Revisa los logs del servidor periódicamente. En Syspanel, puedes acceder a los registros de error desde la sección de "Logs" o "Registros".
No instales módulos de fuentes dudosas. Un módulo mal programado es la causa número uno de errores fatales.

[TIP] Si tu tienda es crítica para tu negocio, considera contratar un plan de hosting con soporte especializado en PrestaShop. Muchas veces, el error 500 se resuelve con un simple ajuste que ellos pueden hacer por ti en minutos.

Preguntas frecuentes (FAQ)

¿El error 500 significa que he perdido mis datos?

No. El error 500 es un error del servidor, no un error de la base de datos. Tus productos, pedidos y clientes siguen ahí. Solo necesitas corregir la causa técnica para que la tienda vuelva a funcionar.

¿Puedo solucionar el error 500 sin acceso al back-office?

Sí, casi siempre. Puedes usar FTP o el administrador de archivos de tu panel de hosting (como Syspanel) para editar archivos, cambiar permisos o renombrar carpetas. También puedes cambiar la versión de PHP desde el panel.

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

Depende de la causa. Si es un problema de permisos, puedes solucionarlo en 10 minutos. Si es un módulo conflictivo, puede llevarte media hora de pruebas. Si es un problema de base de datos, puede requerir más tiempo y experiencia.

¿Debo contratar a un profesional?

Si has seguido todos los pasos de esta guía y el error persiste, puede ser el momento de pedir ayuda profesional. Un desarrollador con experiencia en PrestaShop podrá diagnosticar el problema en menos tiempo del que te llevaría a ti seguir probando.

¿Qué hago si el error 500 aparece solo en el back-office?

Eso suele indicar un problema con un módulo de administración o con la caché de la parte administrativa. Prueba a borrar la carpeta var/cache y a desactivar los módulos de administración recientes.

¿Syspanel es lo mismo que HestiaCP?

Sí, Syspanel es el nuevo nombre del panel de control que antes se conocía como HestiaCP. La funcionalidad es la misma y el acceso se realiza por el puerto 2106. Si tienes documentación antigua que menciona HestiaCP, todos los pasos son aplicables en Syspanel.

Conclusión

El error 500 PrestaShop puede parecer aterrador, pero en la gran mayoría de los casos tiene una solución sencilla que puedes aplicar tú mismo. Siguiendo esta guía paso a paso, podrás diagnosticar si el problema está en los permisos, en la memoria PHP, en un módulo, en la versión de PHP o en el archivo .htaccess. Y lo más importante: sabrás cómo prevenirlo en el futuro.

Recuerda que la paciencia es clave. Ve probando un cambio a la vez y comprobando si la tienda carga correctamente. Si algo no funciona, revierte el cambio y prueba con el siguiente paso. Y si te sientes abrumado, no dudes en pedir ayuda a tu hosting o a un profesional. Tu tienda volverá a estar operativa antes de lo que crees.