Error 500 en PrestaShop en Syspanel: causas y solución

¡Hola! Soy el soporte técnico de tu hosting. Si has llegado hasta aquí, seguramente te has encontrado con la temida pantalla en blanco o el mensaje "Error 500 Internal Server Error" en tu tienda PrestaShop. No te preocupes, es el error más común en servidores y, por suerte, casi siempre tiene solución.

Este error significa que algo salió mal en el servidor, pero no nos dice exactamente qué. Es como si tu coche no arrancara pero el tablero no te diera ninguna luz de advertencia. Vamos a ponernos manos a la obra para solucionar el error 500 PrestaShop Syspanel paso a paso.

¿Qué es exactamente el error 500 y por qué ocurre?

El error 500 PrestaShop Syspanel es un error genérico del lado del servidor. En PrestaShop, suele deberse a:

Problemas de permisos de archivos o carpetas. Es la causa más frecuente.
Un módulo o tema defectuoso que está forzando un error de PHP.
Límite de memoria PHP excedido. Tu tienda necesita más memoria de la que el servidor le permite.
Archivos .htaccess corruptos o mal configurados.
Un error en la configuración de la base de datos.
Actualizaciones incompletas de PrestaShop o de algún módulo.

Como no podemos ver el error directamente, vamos a activar el modo debug de PrestaShop para que nos muestre el mensaje real. Luego solucionaremos lo que sea.

Paso 1: Activar el modo debug de PrestaShop (la clave para todo)

El modo debug es como una lupa que te dirá exactamente qué archivo o línea está causando el PrestaShop error servidor. Para activarlo, necesitas acceder a tu servidor a través de Syspanel.

Accede a Syspanel (antes HestiaCP)

Abre tu navegador y escribe: https://tudominio.com:2106 (recuerda, el puerto es 2106).
Introduce tu usuario y contraseña de Syspanel.

Editar el archivo de configuración

Dentro de Syspanel, busca la sección "Administrador de archivos" (normalmente en el menú lateral izquierdo).
Navega hasta la carpeta raíz de tu tienda PrestaShop (suele ser public_html o web).
Busca el archivo config/defines.inc.php.
Haz clic derecho sobre él y selecciona "Editar".

Dentro del archivo, busca esta línea (normalmente está al principio):

define('_PS_MODE_DEV_', false);

Cámbiala por:

define('_PS_MODE_DEV_', true);

Guarda los cambios y cierra el editor.

[INFO] Si no encuentras el archivo, puede que esté oculto. En Syspanel, en la parte superior del administrador de archivos, activa la opción "Mostrar archivos ocultos" (archivos que empiezan con un punto).

¿Qué acaba de pasar?

Al poner _PS_MODE_DEV_ en true, PrestaShop mostrará en pantalla el error real, con el nombre del archivo problemático y la línea exacta. Por ejemplo, podría decir: Fatal error: Allowed memory size of 134217728 bytes exhausted (límite de memoria) o Parse error: syntax error, unexpected... (error de código en un módulo).

Copia ese mensaje de error. Ahora sabes qué buscar.

Paso 2: Solucionar según el error que veas

Dependiendo del mensaje que te aparezca, actúa de una de estas maneras:

Si el error es de memoria (Allowed memory size...)

Esto es muy común en tiendas con muchos productos o módulos pesados.

Vuelve a Syspanel.
Busca el archivo config/settings.inc.php (o app/config/parameters.php si es PrestaShop 1.7+).
Edítalo y busca la línea: define('_PS_MEMORY_LIMIT_', '128M');
Cámbiala a 256M o 512M. Por ejemplo: define('_PS_MEMORY_LIMIT_', '256M');
Guarda el archivo.

[TIP] Si no encuentras esa línea, puedes añadirla al final del archivo, justo antes del ?>.

Si el error menciona un módulo o tema concreto

El error dirá algo como: .../modules/nombredelmodulo/nombredelarchivo.php o .../themes/tutema/....

Desde el administrador de archivos de Syspanel, renombra la carpeta del módulo o tema problemático. Por ejemplo, si el módulo se llama supermodulo, cambia el nombre a supermodulo_old.
Esto desactivará el módulo/tema. Luego puedes eliminarlo o reinstalarlo más tarde.
Refresca tu tienda. Si el error desaparece, ya sabes quién es el culpable.

Si el error es un "Parse error" o "syntax error"

Esto indica un archivo PHP dañado, a menudo por una edición manual incorrecta o una actualización fallida.

Localiza el archivo exacto que menciona el error.
Si tienes una copia de seguridad, reemplázalo.
Si no, puedes restaurar el archivo original desde una instalación limpia de PrestaShop de la misma versión.

Paso 3: Solucionar sin ver el error (si no pudiste activar el modo debug)

A veces el error es tan grave que ni siquiera te deja editar el archivo, o el modo debug no se activa. No pasa nada, prueba estas soluciones genéricas en orden:

1. Restaurar el archivo .htaccess

El archivo .htaccess se corrompe a menudo después de cambios en la URL o módulos de SEO.

Ve a Syspanel > Administrador de archivos.
Busca el archivo .htaccess en la raíz de tu tienda.
Renómbralo a .htaccess_old.
Ve a tu back office de PrestaShop (si puedes acceder) y ve a Parámetros de la tienda > Tráfico y SEO y haz clic en "Guardar" (sin cambiar nada). Esto regenerará el .htaccess.
Si no puedes acceder al back office, crea un archivo .htaccess nuevo y vacío (solo con el contenido básico). Pero mejor intenta regenerarlo desde el back office.

2. Aumentar el límite de memoria sin editar archivos

Si no puedes editar settings.inc.php, prueba desde Syspanel:

Ve a "Ajustes de PHP" (o "PHP Settings") en el menú de Syspanel.
Busca la opción memory_limit y cámbiala a 256M o 512M.
Guarda y reinicia el servicio PHP (normalmente hay un botón "Reiniciar" o "Restart").

3. Verificar permisos de archivos y carpetas

Los permisos incorrectos son otra causa frecuente del error 500 PrestaShop Syspanel.

En Syspanel, dentro del administrador de archivos, selecciona la carpeta raíz de tu tienda (normalmente public_html). Luego, en la barra superior, busca la opción "Permisos" o "Chmod".

Establece los siguientes permisos (si no sabes, pide a tu soporte que lo haga):

Carpetas: 755 (rwxr-xr-x)
Archivos: 644 (rw-r--r--)
Archivos de configuración (config/settings.inc.php, app/config/parameters.php): 444 (solo lectura) o 644 (si necesitas editarlos).

[WARNING] No pongas permisos 777 a menos que sea estrictamente necesario y solo temporalmente. Es un riesgo de seguridad.

Paso 4: Desactivar módulos desde la base de datos (solución de emergencia)

Si el error impide acceder tanto al front como al back office, puedes desactivar todos los módulos desde la base de datos.

En Syspanel, busca la sección "phpMyAdmin" o "Base de datos".
Selecciona la base de datos de tu PrestaShop.
Busca la tabla ps_modules (o ps_module si es PrestaShop 1.6).
Haz clic en "Examinar".
Marca la casilla superior para seleccionar todas las filas.
En el menú desplegable "Con seleccionados", elige "Editar".
En la columna active, cambia todos los valores de 1 a 0.
Guarda los cambios.

Esto desactivará todos los módulos. Luego intenta acceder a tu tienda; si funciona, el problema era un módulo. Actívalos de uno en uno desde el back office para encontrar al culpable.

Paso 5: Preguntas frecuentes (FAQ)

¿Por qué aparece el error 500 solo en algunas páginas?

Suele ser un módulo que solo se carga en esas páginas (por ejemplo, un módulo de pago en el carrito). Activa el modo debug para identificar el módulo.

¿El error 500 puede deberse a una actualización de PrestaShop?

Sí, las actualizaciones pueden dejar archivos incompatibles o modificar el .htaccess. Siempre haz una copia de seguridad antes de actualizar.

¿Qué hago si no puedo acceder ni a Syspanel?

Contacta con tu proveedor de hosting. Si tu hosting usa Syspanel, el acceso suele ser con el puerto 2106, pero si el servidor está caído, solo ellos pueden ayudarte.

¿Restablecer los permisos a 644 y 755 es suficiente?

En la mayoría de los casos sí. Pero si tu hosting tiene un PHP handler especial (como suPHP o FastCGI), los permisos pueden necesitar ser 755 para archivos también. Consulta con tu soporte.

Resumen y consejo final

El error 500 PrestaShop Syspanel suena aterrador, pero es como un juego de pistas. Activa el modo debug, lee el mensaje y actúa en consecuencia. Si no puedes, prueba las soluciones genéricas: restaurar .htaccess, aumentar memoria y desactivar módulos.

[TIP] Si después de todo esto el error persiste, contacta con el soporte técnico de tu hosting. Diles que has seguido estos pasos y facilítales el mensaje de error que obtuviste con el modo debug. Así te ayudarán mucho más rápido.

Espero que este artículo te haya servido. ¡No te rindas! Tu tienda volverá a funcionar. Si tienes alguna duda, déjala en los comentarios (si los hay) o escribe a tu soporte. ¡Buena suerte!