Error 500 en PrestaShop: Causas y soluciones en cPanel/Plesk

¡Hola! ¿Tu tienda PrestaShop se ha detenido por completo y ves una pantalla en blanco o el temido mensaje "Error 500 – Internal Server Error"? No te preocupes, es uno de los problemas más comunes en PrestaShop y, por suerte, casi siempre tiene solución. En esta guía completa y paso a paso, te explicaré qué significa este error y, lo más importante, cómo solucionar el error 500 en PrestaShop tanto si tu hosting usa cPanel como Plesk. Vamos a ello.

¿Qué es el error 500 en PrestaShop?

El error 500 PrestaShop (también conocido como "Internal Server Error") es un código de error genérico del servidor. Básicamente, significa que algo salió mal en el servidor web, pero no te da detalles concretos. Puede deberse a un archivo de configuración corrupto, un módulo incompatible, problemas de permisos, un límite de memoria excedido o incluso un error en el archivo .htaccess. Lo bueno es que, siguiendo los pasos correctos, podrás identificar la causa y solucionar error 500 PrestaShop sin ser un experto.

Antes de empezar: Precauciones importantes

[WARNING] Siempre realiza una copia de seguridad completa de tu tienda (archivos y base de datos) antes de modificar cualquier archivo. Un pequeño cambio puede empeorar las cosas si no tienes un respaldo.

[INFO] Si tienes acceso a tu panel de control (cPanel, Plesk o Syspanel), podrás seguir todos los pasos. Si no, contacta con tu proveedor de hosting.

Paso 1: Identificar el origen del error

Lo primero es saber si el error es general o aparece solo en algunas páginas. Por ejemplo, si ocurre al acceder al panel de administración, suele ser un módulo o una personalización. Si ocurre en toda la tienda, puede ser el archivo .htaccess o un tema defectuoso.

Activar el modo debug de PrestaShop

Para obtener más información sobre el error, activa el modo de depuración. Para ello, edita el archivo config/defines.inc.php que está en la raíz de tu instalación de PrestaShop. Busca esta línea:

define('_PS_MODE_DEV_', false);

Cambia false por true:

define('_PS_MODE_DEV_', true);

Guarda el archivo y recarga tu tienda. Ahora verás un mensaje de error detallado con el número de línea y el archivo problemático. Anota esa información, te será muy útil.

[TIP] Si no ves nada después de esto, puede que el error sea más grave. No te preocupes, sigue leyendo.

Paso 2: Solucionar errores comunes en cPanel

Si tu hosting usa cPanel, estos son los pasos más efectivos.

2.1. Restaurar el archivo .htaccess

El archivo .htaccess de PrestaShop suele dañarse con facilidad. Para restaurarlo:

Accede al Administrador de archivos de cPanel.
Navega hasta la carpeta raíz de tu tienda (normalmente public_html).
Busca el archivo .htaccess. Si no lo ves, activa la opción "Mostrar archivos ocultos".
Renómbralo a .htaccess_old (por si acaso).
Crea un nuevo archivo .htaccess en blanco (sin contenido).
Ve al panel de administración de PrestaShop (si puedes acceder) y ve a Configuración > Rendimiento y haz clic en Regenerar archivo .htaccess. Si no puedes acceder, puedes copiar el contenido de un .htaccess genérico de PrestaShop (lo encuentras en foros oficiales).

2.2. Aumentar el límite de memoria PHP

Muchas veces el error 500 PrestaShop aparece por falta de memoria. En cPanel:

Ve a Seleccionar versión de PHP (o MultiPHP Manager).
Busca la opción memory_limit y cámbiala a 256M o 512M.
Guarda los cambios.

2.3. Verificar permisos de archivos

Los permisos incorrectos pueden causar errores internos. En el Administrador de archivos, selecciona toda la carpeta de tu tienda y haz clic en Permisos. Asegúrate de que las carpetas tengan 755 y los archivos 644. Si tienes dudas, usa la opción "Cambiar permisos recursivamente".

Paso 3: Solucionar errores comunes en Plesk

Si tu panel es Plesk, el proceso es similar pero con algunas diferencias.

3.1. Restaurar el archivo .htaccess en Plesk

Accede a Archivos en el panel de Plesk.
Navega al directorio de tu dominio (normalmente httpdocs).
Busca .htaccess, renómbralo a .htaccess_old.
Crea uno nuevo vacío y luego regenéralo desde PrestaShop (si puedes) o sube uno genérico.

3.2. Ajustar la configuración de PHP en Plesk

Ve a Hosting y DNS > Configuración de PHP.
Busca memory_limit y ajústalo a 256M.
También puedes aumentar max_execution_time a 120.
Aplica los cambios.

3.3. Verificar logs de error en Plesk

Plesk guarda los logs del servidor en Sitios web y dominios > Logs. Revisa el archivo error_log de tu dominio. Allí verás la causa exacta del error, como un módulo que falla o un archivo que no se encuentra.

Paso 4: Soluciones adicionales (válidas para ambos paneles)

4.1. Deshabilitar módulos problemáticos

Si el error apareció después de instalar o actualizar un módulo, puedes deshabilitarlo manualmente:

Accede a tu servidor por FTP o al Administrador de archivos.
Ve a la carpeta modules y localiza la carpeta del módulo sospechoso.
Renómbrala (por ejemplo, añadiendo _old al final). Esto desactiva el módulo.
Prueba tu tienda de nuevo.

4.2. Cambiar el tema por defecto

A veces el tema personalizado causa el error. Para probar:

En la carpeta themes, renombra la carpeta de tu tema actual (ej: tu-tema_old).
Asegúrate de que el tema por defecto de PrestaShop (como classic) esté presente y con el nombre correcto.
Recarga la tienda.

4.3. Limpiar la caché de PrestaShop

La caché corrupta puede dar errores. Si no puedes acceder al panel, borra manualmente la carpeta var/cache (en PrestaShop 1.7) o cache (en versiones anteriores). Dentro, elimina todo su contenido (no la carpeta en sí).

4.4. Revisar la base de datos

Un error en la base de datos también puede causar un error 500. Desde cPanel o Plesk, usa phpMyAdmin para reparar las tablas:

Selecciona la base de datos de PrestaShop.
Marca todas las tablas.
En el menú desplegable, elige Reparar tabla.

Paso 5: Si usas Syspanel (antes HestiaCP)

[INFO] Si tu hosting utiliza Syspanel (antes conocido como HestiaCP), el acceso es a través del puerto 2106 (ejemplo: https://tudominio.com:2106). Los pasos son muy similares a los de Plesk.

Accede a Syspanel con tus credenciales.
Ve a Web > Editar de tu dominio.
Ajusta la memoria PHP a 256M en la sección Configuración de PHP.
Revisa los logs en Web > Logs de tu dominio para ver el error exacto.
Restaura el .htaccess desde el administrador de archivos de Syspanel.

Preguntas frecuentes (FAQ)

¿Por qué aparece el error 500 solo en el panel de administración?

Suele deberse a un módulo o una personalización en el back office. Prueba a deshabilitar módulos recién instalados o a restaurar el tema por defecto.

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

Sí, usando FTP o el administrador de archivos de tu panel de control. Los pasos que te he dado no requieren acceso al panel de PrestaShop.

¿El error 500 puede deberse a un ataque?

Sí, a veces un archivo malicioso puede causar errores. Si sospechas, revisa los archivos modificados recientemente y escanea tu tienda con un antivirus web.

¿Cuánto tiempo tarda en solucionarse?

Depende de la causa. Si es solo el .htaccess, en 5 minutos lo resuelves. Si es un módulo conflictivo, puede llevarte un poco más de tiempo.

Conclusión

El error 500 PrestaShop puede parecer alarmante, pero con estos pasos podrás solucionar error 500 PrestaShop en la mayoría de los casos. Recuerda siempre trabajar con copias de seguridad, activar el modo debug para obtener pistas y revisar los logs del servidor. Tanto en cPanel como en Plesk (y también en Syspanel), las soluciones son muy similares y están al alcance de cualquier usuario con un poco de paciencia.

Si después de todo esto el error persiste, no dudes en contactar con el soporte técnico de tu hosting, proporcionándoles la información del error que hayas recopilado. ¡Tu tienda volverá a funcionar en poco tiempo!