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

¡Hola! Soy tu técnico de soporte amigable. Si estás aquí, seguramente te has encontrado con la temida pantalla blanca o el mensaje "Error 500 - Internal Server Error" en tu tienda PrestaShop. No te preocupes, es uno de los problemas más comunes y, por suerte, casi siempre tiene solución. En esta guía extensa y detallada, te voy a explicar paso a paso cómo solucionar el error 500 en PrestaShop, tanto si usas cPanel como Plesk. Vamos a desglosar las causas más frecuentes y las soluciones más efectivas para que puedas recuperar tu tienda en pocos minutos.

¿Qué es el Error 500 en PrestaShop?

El error 500 es un código de estado HTTP genérico que significa "Error Interno del Servidor". En términos sencillos, tu servidor web (Apache o Nginx) intentó ejecutar el código de PrestaShop, pero algo salió mal en el proceso. No te da detalles porque, por seguridad, el servidor no muestra información sensible al usuario. La buena noticia es que, al ser un error tan común, existen métodos probados para solucionar error 500 en PrestaShop, independientemente del panel de control que uses.

[INFO] El error 500 puede aparecer de repente después de instalar un módulo, cambiar un tema, modificar un archivo .htaccess o incluso sin razón aparente tras una actualización. No te asustes, es parte del día a día de cualquier tienda online.

Causas Comunes del Error 500 en PrestaShop

Antes de lanzarnos a las soluciones, es útil entender qué puede estar causando el problema. Las causas más habituales son:

1. Archivos de configuración corruptos: Principalmente el config/defines.inc.php o config/settings.inc.php.
2. Problemas con el archivo .htaccess: Reglas incorrectas o incompatibles.
3. Módulos o temas defectuosos: Un módulo mal codificado o un tema incompatible con tu versión de PrestaShop.
4. Límites de memoria PHP excedidos: El servidor se queda sin memoria para ejecutar el script.
5. Permisos de archivos incorrectos: Archivos o carpetas con permisos demasiado restrictivos o demasiado abiertos.
6. Errores en la base de datos: Tablas corruptas o datos inconsistentes.
7. Problemas con el certificado SSL o la caché del servidor.

Preparación: Accede a los Archivos de tu Tienda

Para aplicar las siguientes soluciones, necesitarás acceder al sistema de archivos de tu tienda. Dependiendo de tu panel de control, el método varía ligeramente.

Acceso vía cPanel (La mayoría de los hosting compartidos)

1. Inicia sesión en tu cPanel.
2. Busca la sección "Archivos" y haz clic en "Administrador de Archivos".
3. Selecciona la carpeta raíz de tu dominio (normalmente public_html o www).
4. Verás todos los archivos de tu PrestaShop. Desde aquí podrás editar, renombrar o eliminar archivos.

Acceso vía Plesk (Hosting más avanzado o servidores dedicados)

1. Inicia sesión en tu Plesk.
2. Ve a "Sitios web y dominios" y selecciona el dominio de tu tienda.
3. Haz clic en "Administrador de archivos" (normalmente en la parte derecha).
4. Navega hasta la carpeta httpdocs (es la raíz de tu sitio).

Acceso vía Syspanel (HestiaCP)

[TIP] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el acceso es muy similar. Simplemente ingresa a tu panel a través del puerto 2106 (ejemplo: https://tudominio.com:2106). Luego, ve a la sección "Web" y haz clic en "Administrador de archivos" junto a tu dominio. La estructura de carpetas es la misma: public_html.

Solución Paso a Paso: Cómo Resolver el Error 500 en PrestaShop

Vamos a empezar con las soluciones más rápidas y menos invasivas. Si una no funciona, pasa a la siguiente.

Paso 1: Activar el Modo Debug (Depuración) de PrestaShop

El error 500 es genérico, pero PrestaShop tiene un modo de depuración que muestra el error real. Para activarlo, tienes que editar un archivo de configuración.

1. Accede al Administrador de Archivos de tu panel (cPanel, Plesk o Syspanel).
2. Localiza el archivo config/defines.inc.php dentro de la carpeta de tu tienda.
3. Haz clic derecho sobre él y selecciona "Editar" (o "Code Editor").
4. Busca la línea que dice: define('_PS_MODE_DEV_', false);
5. Cámbiala a: define('_PS_MODE_DEV_', true);
6. Guarda el archivo. Ahora, al recargar tu tienda, en lugar del error 500, verás un mensaje de error detallado (por ejemplo, "Fatal error: Class 'Module' not found...").
7. Anota ese mensaje de error. Es la clave para saber qué está fallando exactamente.
8. Una vez solucionado el problema, NO OLVIDES volver a poner false para desactivar el modo debug en producción. Si no lo haces, tu tienda mostrará información sensible a los visitantes.

[WARNING] No dejes el modo debug activado en una tienda en producción. Es un riesgo de seguridad y puede mostrar información privada a los usuarios.

Paso 2: Deshabilitar Módulos y Temas Problemáticos

El error 500 suele aparecer justo después de instalar o actualizar un módulo. Si el modo debug te muestra un error relacionado con una clase o archivo de un módulo específico, ese es el culpable. La solución más rápida es deshabilitarlo manualmente.

1. Renombrar la carpeta del módulo: Dentro del Administrador de Archivos, ve a la carpeta modules. Busca la carpeta del módulo problemático (por ejemplo, modules/mimoduloroto). Cámbiale el nombre añadiendo un guion bajo al final, por ejemplo: _mimoduloroto. Al hacer esto, PrestaShop no podrá cargarlo y, por lo tanto, no generará el error.
2. Deshabilitar el tema: Si el error no es de un módulo, puede ser del tema. Ve a la carpeta themes. Busca la carpeta de tu tema activo (ejemplo: themes/mitema). Cámbiale el nombre a _mitema. PrestaShop usará el tema por defecto (classic o default). Si el error desaparece, el tema es el problema.
3. Probar: Recarga tu tienda. Si el error 500 desaparece, has encontrado al responsable. Ahora puedes reinstalar el módulo o tema desde el backoffice (si es posible) o contactar al desarrollador.

Paso 3: Regenerar el Archivo .htaccess

Un archivo .htaccess corrupto es una causa muy común del error 500 PrestaShop. Vamos a regenerarlo.

1. En el Administrador de Archivos, localiza el archivo .htaccess en la raíz de tu tienda.
2. Renómbralo a algo como .htaccess_viejo o simplemente bórralo (no te preocupes, PrestaShop lo recreará).
3. Ahora, accede a tu backoffice de PrestaShop (si puedes). Ve a Parámetros de la tienda > Tráfico y SEO > SEO y URLs.
4. Desplázate hasta la sección "Configuración de URL amigable" y haz clic en "Guardar". Esto forzará a PrestaShop a regenerar un nuevo .htaccess limpio.
5. Si no puedes acceder al backoffice, no pasa nada. A veces, al recargar la tienda, PrestaShop lo regenera automáticamente. Si no, tendrás que crearlo manualmente (es un archivo de texto plano con reglas específicas, pero mejor prueba el siguiente paso primero).

Paso 4: Aumentar los Límites de Memoria PHP

A veces, el error aparece porque el script de PrestaShop necesita más memoria de la que el servidor le asigna. Puedes intentar aumentarlo desde el archivo config/defines.inc.php o desde el panel de control.

Opción A: Desde cPanel

1. En cPanel, busca la sección "Software" y haz clic en "Seleccionar versión de PHP".
2. Haz clic en "Switch to PHP Options" (o similar).
3. Busca la opción memory_limit y cámbiala a 256M o 512M. También puedes aumentar max_execution_time a 120 o 300.
4. Guarda los cambios.

Opción B: Desde Plesk

1. En Plesk, ve a "Sitios web y dominios" y haz clic en "Configuración de PHP" para tu dominio.
2. Busca la opción memory_limit y ajústala. Guarda.

Opción C: Desde Syspanel (HestiaCP)

1. En Syspanel, ve a la sección "Web" y haz clic en el botón "Configuración avanzada" (o el icono de engranaje) junto a tu dominio.
2. Busca la opción "PHP-FPM" y edita los parámetros. Ajusta memory_limit y max_execution_time.
3. Guarda y recarga el servicio PHP.

Paso 5: Verificar y Corregir Permisos de Archivos

Los permisos incorrectos pueden impedir que PrestaShop lea o escriba archivos, generando un error 500.

1. Para la mayoría de los archivos: Deben tener permisos 644 (lectura y escritura para el propietario, solo lectura para el grupo y otros).
2. Para las carpetas: Deben tener permisos 755 (lectura, escritura y ejecución para el propietario; lectura y ejecución para el grupo y otros).
3. Carpetas especiales: Las carpetas cache, img, log, modules, themes y upload a veces requieren permisos 777 para que el servidor pueda escribir en ellas (por ejemplo, al generar imágenes o instalar módulos). Sin embargo, 777 es un riesgo de seguridad. Intenta con 755 primero; si da error, prueba con 775 o 777 temporalmente, y luego vuélvelos a 755.

Cómo hacerlo en el Administrador de Archivos:

1. Selecciona todos los archivos y carpetas (Ctrl+A).
2. Haz clic en "Permisos" (o "Change Permissions").
3. Marca las casillas correspondientes (por ejemplo, para 755: propietario: leer, escribir, ejecutar; grupo: leer, ejecutar; otros: leer, ejecutar).
4. Aplica.

Paso 6: Restaurar un Backup Reciente

Si nada de lo anterior funciona, la solución más rápida y segura es restaurar una copia de seguridad de tu tienda de antes de que apareciera el error. Esto es especialmente útil si el problema se desencadenó por una actualización o instalación.

1. Desde cPanel: Ve a la sección "Archivos" > "Copias de seguridad" y restaura el archivo de la carpeta public_html (o www) y la base de datos.
2. Desde Plesk: Ve a "Sitios web y dominios" y haz clic en "Copias de seguridad". Selecciona la copia más reciente antes del error y haz clic en "Restaurar".
3. Desde Syspanel (HestiaCP): Ve a la sección "Backup" y selecciona la copia de seguridad de tu dominio. Puedes restaurar tanto los archivos como la base de datos.

[INFO] Si no tienes backups automáticos, es una buena práctica configurarlos cuanto antes. La mayoría de los paneles (cPanel, Plesk, Syspanel) ofrecen esta funcionalidad.

Preguntas Frecuentes (FAQ)

P: ¿El error 500 puede ser culpa de mi hosting?
R: Sí, a veces el problema está en el servidor (ej: un servicio caído, actualización de PHP, cuota de disco llena). Contacta con tu soporte de hosting si has probado todo lo anterior.

P: ¿Qué hago si no puedo acceder ni al backoffice ni al Administrador de Archivos?
R: Contacta a tu proveedor de hosting inmediatamente. Ellos pueden acceder al servidor a nivel de sistema y revisar los logs de error (archivos de registro) para darte una pista más precisa.

P: ¿Es seguro borrar el archivo .htaccess?
R: Sí, es seguro. PrestaShop lo regenera automáticamente con las reglas correctas al guardar la configuración de URLs amigables. Si no puedes guardar desde el backoffice, puedes crear uno básico tú mismo, pero es más sencillo dejarlo regenerar.

P: Mi error 500 solo ocurre en la página de inicio, pero las demás funcionan. ¿Qué puede ser?
R: Esto suele estar relacionado con un módulo de la página de inicio (sliders, banners, etc.) o con un problema en el archivo index.php de la raíz. Prueba a deshabilitar módulos de la home uno por uno.

Conclusión

El error 500 PrestaShop es un dolor de cabeza, pero como has visto, casi siempre tiene solución. Hemos recorrido desde activar el modo debug para obtener pistas, hasta deshabilitar módulos, regenerar el .htaccess, ajustar la memoria PHP y verificar permisos. La clave está en la paciencia y en seguir los pasos de forma ordenada.

Recuerda, si usas cPanel, Plesk o Syspanel (puerto 2106), los pasos son muy similares. Y si todo falla, tu último recurso es restaurar un backup o contactar al soporte técnico de tu hosting.

Espero que esta guía te haya sido de gran ayuda. ¡Tu tienda volverá a funcionar en poco tiempo! Si tienes alguna otra duda, no dudes en consultar la documentación oficial de PrestaShop o escribir a tu equipo de soporte. ¡Ánimo!