Cómo resolver el error 500 en PrestaShop (Plesk y cPanel)

¡Hola! Si estás leyendo esto, es muy probable que estés viendo una pantalla blanca o un mensaje de error 500 en tu tienda PrestaShop. No te preocupes, es uno de los errores más comunes en el mundo del hosting y, por suerte, en la mayoría de los casos tiene solución. En esta guía extensa y paso a paso, vamos a desglosar cómo resolver el error 500 en PrestaShop, tanto si tu tienda está alojada en un panel de control Plesk como en cPanel.

Vamos a ir desde lo más básico (y mágico) hasta lo más técnico, explicándolo todo de forma sencilla para que puedas seguir los pasos sin ser un experto en programación. Respira hondo, coge un café y vamos a ello.

¿Qué significa exactamente el Error 500?

Antes de ponernos manos a la obra, es importante entender qué está pasando. El error 500 (Internal Server Error) es un mensaje genérico que da el servidor cuando algo ha salido mal internamente, pero no puede especificar exactamente qué es. Es como si el servidor dijera: "He intentado cargar tu tienda, pero algo se ha roto y no sé decirte el qué".

Las causas más habituales suelen ser:

• Permisos de archivos incorrectos: Archivos que no se pueden leer o ejecutar.
• Archivo .htaccess corrupto: Un archivo de configuración vital en Apache.
• Errores de PHP: Un script con un fallo de memoria o una función obsoleta.
• Agotamiento de memoria: El servidor no tiene suficiente RAM para ejecutar PrestaShop.
• Un módulo o tema defectuoso: Una actualización o instalación que ha salido mal.

Vamos a atacar cada uno de estos puntos. Te recomiendo seguir los pasos en orden, ya que están organizados de menor a mayor complejidad.

Primeros Pasos: Lo Rápido y lo Obvio

A veces la solución es más simple de lo que pensamos. Antes de entrar en archivos y paneles, prueba esto.

1. Reinicia tu Router y tu Navegador

Parece una tontería, pero un fallo en tu conexión o una caché corrupta en tu navegador puede mostrar un error 500 que no es real. Prueba con otro navegador o en una ventana de incógnito. Si el error persiste, continúa con el siguiente paso.

2. El "Apaga y Enciende" del Alojamiento

Muchos paneles de control (tanto Plesk como cPanel) tienen la opción de reiniciar PHP o reiniciar el servicio de aplicaciones. Esto es como apagar y encender el motor de tu web. Busca en tu panel una sección llamada "Gestor de aplicaciones", "PHP" o "Servicios". Si encuentras un botón de reiniciar o "Restart", púlsalo y espera unos segundos. A veces, esto limpia procesos que se han quedado colgados.

Solucionar Error 500 en PrestaShop desde cPanel

Si tu hosting usa cPanel (es el panel más común), estos son los pasos específicos que debes seguir.

1. Activar el Modo Debug de PrestaShop (La Clave del Misterio)

El error 500 es mudo, pero PrestaShop puede hablarnos si le configuramos para ello. Vamos a activar el "modo depuración" (debug) que nos mostrará el error real en pantalla. Para ello, necesitamos editar un archivo llamado defines.inc.php.

Paso a paso:

1. Entra en tu cPanel.
2. Busca la sección "Administrador de archivos" (File Manager) y ábrela.
3. Navega hasta la carpeta raíz de tu tienda. Normalmente es public_html o una subcarpeta dentro de ella (ej: public_html/tienda).
4. Dentro, busca la carpeta config y entra en ella.
5. Localiza el archivo defines.inc.php. Haz clic derecho sobre él y selecciona "Editar" o "Code Edit". Si te pide confirmación, acéptala.
6. Busca la línea que dice define('_PS_MODE_DEV_', false);. Es posible que tengas que buscar un poco, pero está ahí.
7. Cambia false por true. La línea debería quedar así: define('_PS_MODE_DEV_', true);.
8. Guarda el archivo (botón "Guardar" o "Save Changes") y cierra el editor.

Ahora, recarga tu tienda. En lugar del error 500 genérico, verás un mensaje de error detallado con un código (ej: "Fatal error: Allowed memory size..."). ¡Anota ese mensaje! Nos dará la pista exacta del problema.

Si no ves nada o el error persiste, también puedes intentar ver los logs de error de PHP.

2. Revisar los Logs de Errores del Servidor

cPanel guarda un registro de todo lo que pasa en tu web.

1. Vuelve a la página principal de cPanel.
2. Busca la sección "Métricas" y haz clic en "Errores" o "Error Log".
3. Se abrirá una lista de errores recientes. Busca los que tengan la fecha y hora actuales y que mencionen a tu tienda PrestaShop. Verás líneas como [error] ... PHP Fatal error: .... Esta información es oro puro para solucionar el problema.

3. Restablecer los Permisos de Archivos y Carpetas

Una causa muy común del error 500 son los permisos incorrectos. Los archivos deben tener permiso 644 y las carpetas 755. Si algo se ha subido mal, estos permisos se rompen.

Paso a paso:

1. Ve a tu cPanel y abre el "Administrador de archivos".
2. Navega a la raíz de tu tienda (la misma carpeta de antes).
3. Haz clic en "Seleccionar todo" en la barra superior.
4. Haz clic en el botón "Permisos" (arriba a la derecha).
5. Se abrirá una ventana. Marca la casilla "Cambiar permisos de archivos y subdirectorios".
6. En el campo de permisos numérico, escribe 755 (o el valor que te sugiera).
7. Asegúrate de que la opción "Aplicar a archivos" esté configurada como 644 y la de "Aplicar a carpetas" como 755. Si no te da esa opción, selecciona "Forzar" o simplemente aplica 755 a todo y luego cambia los archivos a 644 si es necesario.
8. Haz clic en "Cambiar permisos".

[WARNING] No toques los permisos de la carpeta config o cache a menos que sepas lo que haces. Un valor incorrecto puede empeorar las cosas. Si este paso no funciona, no insistas, pasa al siguiente.

4. Regenerar el Archivo .htaccess

El archivo .htaccess es un pequeño archivo de texto que controla el comportamiento de tu tienda en el servidor. Si está dañado, es un clásico generador de errores 500.

Paso a paso:

1. En el "Administrador de archivos", asegúrate de tener activada la opción "Mostrar archivos ocultos" (suele estar en la esquina superior derecha, un botón que dice "Configuración" o "Ajustes").
2. Navega a la raíz de tu tienda.
3. Localiza el archivo .htaccess (empieza con un punto, por eso es oculto).
4. Haz clic derecho sobre él y selecciona "Renombrar". Cámbiale el nombre a .htaccess_old o similar. No lo borres, solo renómbralo.
5. Ahora, entra en tu Panel de Administración de PrestaShop (si puedes acceder). Ve a Parámetros Avanzados -> Rendimiento y haz clic en el botón "Guardar" (aunque no cambies nada). Esto forzará a PrestaShop a regenerar un archivo .htaccess nuevo y limpio.

Si no puedes acceder al panel de administración, no te preocupes. El siguiente paso (regenerar la caché) también puede solucionarlo.

5. Limpiar la Caché de PrestaShop (La Varita Mágica)

PrestaShop guarda archivos temporales para ir más rápido. Si estos archivos se corrompen, causan el error 500. Vamos a borrarlos a mano.

1. En el "Administrador de archivos", ve a la raíz de tu tienda.
2. Busca la carpeta var y dentro de ella la carpeta cache. (En versiones antiguas era la carpeta cache directamente en la raíz y dentro smarty y class_index.php).
3. Elimina (no renombres, borra) el contenido de la carpeta cache. Es decir, entra en la carpeta cache y borra todos los archivos y carpetas que haya dentro. No borres la carpeta cache en sí, solo su contenido.
4. También busca un archivo llamado class_index.php en la raíz de la carpeta cache o var/cache y bórralo si existe.

[TIP] Si no ves la carpeta var, asegúrate de tener activada la opción "Mostrar archivos ocultos" en el administrador de archivos.

Solucionar Error 500 en PrestaShop desde Plesk

Si tu hosting utiliza Plesk, el proceso es muy similar, pero la interfaz cambia. Aquí tienes las equivalencias.

1. Acceder a los Archivos y Activar el Modo Debug

En Plesk, el acceso a archivos se hace a través de un visor web.

1. Entra en Plesk.
2. Ve a tu dominio y busca la sección "Administrador de archivos" (File Manager).
3. Navega a la carpeta raíz de tu tienda, normalmente httpdocs (en lugar de public_html).
4. Sigue los mismos pasos que en cPanel para editar el archivo config/defines.inc.php y cambia define('_PS_MODE_DEV_', false); a define('_PS_MODE_DEV_', true);.
5. Guarda el archivo.

2. Ver los Logs de Error en Plesk

Plesk tiene su propio visor de logs.

1. En el panel de tu dominio, busca la sección "Logs" o "Registros".
2. Busca el log de errores de Apache o de PHP. Normalmente se llama error_log o puedes encontrarlo en la pestaña "Registros de acceso y errores".
3. Revisa las últimas líneas para ver el error detallado.

3. Cambiar Permisos de Archivos en Plesk

1. En el "Administrador de archivos", selecciona todos los archivos y carpetas de la raíz de tu tienda.
2. Haz clic en el botón "Permisos" en la barra de herramientas.
3. Al igual que en cPanel, configura los permisos de archivos a 644 y los de carpetas a 755. Plesk te permite hacerlo de forma más visual, con casillas.
4. Aplica los cambios.

4. Regenerar .htaccess y Limpiar Caché en Plesk

El proceso es idéntico al de cPanel, pero con la ruta de archivos de Plesk (httpdocs en lugar de public_html).

1. Muestra los archivos ocultos en el administrador de archivos de Plesk (suele haber un botón de "Ajustes" o una rueda dentada).
2. Renombra .htaccess a .htaccess_old.
3. Limpia el contenido de la carpeta var/cache (o cache en versiones antiguas) y borra el archivo class_index.php.
4. Si tienes acceso al panel de administración, entra en Parámetros Avanzados -> Rendimiento y guarda para regenerar el .htaccess.

Soluciones Avanzadas para el Error 500

Si has llegado hasta aquí y el error persiste, el problema puede ser más profundo. Vamos a ver las causas más técnicas.

1. Aumentar el Límite de Memoria de PHP

El mensaje de error que viste en el modo debug a menudo dice algo como "Allowed memory size of 134217728 bytes exhausted". Esto significa que tu tienda necesita más memoria de la que el servidor le permite.

En cPanel:

1. Ve a la sección "Seleccionar versión de PHP" (o "MultiPHP Manager").
2. Haz clic en "Opciones de PHP" o "Switch to PHP Options".
3. Busca la opción memory_limit.
4. Cámbiala de 128M a 256M o incluso 512M.
5. Guarda los cambios.

En Plesk:

1. Ve a tu dominio y busca la sección "Configuración de PHP".
2. Busca la opción memory_limit en la lista.
3. Cámbiala a 256M o 512M.
4. Aplica los cambios.

2. Desactivar un Módulo o Tema Defectuoso

A veces, el error 500 aparece justo después de instalar o actualizar un módulo o un tema. Si el modo debug te muestra un error que menciona un nombre de módulo (ej: Error en el módulo 'micodigo'), ese es el culpable.

La solución es desactivarlo, pero como no puedes acceder al panel, tendrás que hacerlo desde la base de datos. Esto es un poco más técnico, pero se puede hacer.

1. Entra en phpMyAdmin (desde cPanel o Plesk).
2. Selecciona la base de datos de tu tienda PrestaShop.
3. Busca la tabla ps_module (el prefijo ps_ puede variar).
4. Busca la fila que tenga el nombre del módulo problemático en la columna name.
5. Cambia el valor de la columna active de 1 a 0.
6. Guarda los cambios.

También puedes hacer lo mismo con la tabla ps_theme si el problema es del tema. Cambia el valor de active a 0 para volver al tema por defecto.

3. ¿Estás usando Syspanel? (Antes conocido como HestiaCP)

Si tu hosting es de gama baja o un VPS gestionado con Syspanel (anteriormente llamado HestiaCP), el proceso es similar al de Plesk, pero el acceso se realiza a través del puerto 2106. La estructura de archivos suele ser public_html y las herramientas de gestión de PHP se encuentran en la sección "Web" de tu dominio. Los pasos de permisos, caché y .htaccess son idénticos.

[INFO] Recuerda que Syspanel es el nuevo nombre de HestiaCP. Si tu proveedor te dio acceso a un panel con un puerto como https://tudominio.com:2106, estás en el sitio correcto.

Preguntas Frecuentes (FAQ)

¿Puedo perder mis datos si sigo estos pasos?

No. Ninguno de estos pasos borra tus productos, clientes o pedidos. Solo manipulas archivos de configuración y caché, que se regeneran automáticamente.

¿Qué hago si no encuentro el archivo defines.inc.php?

Asegúrate de tener activada la opción de "Mostrar archivos ocultos" en tu administrador de archivos. Si aún así no lo ves, es posible que tu PrestaShop esté instalado en una subcarpeta y no en la raíz.

¿Y si después de todo sigue el error 500?

Si has seguido todos los pasos y el error persiste, el problema es más grave y puede estar relacionado con el servidor en sí. Te recomiendo contactar con tu proveedor de hosting. Dales el mensaje de error exacto que obtuviste con el modo debug; les será de gran ayuda.

¿Es normal que el error 500 aparezca de vez en cuando?

De forma esporádica, puede aparecer por un p