Error 500 en PrestaShop: causas y soluciones en cPanel y Plesk

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

El error 500, también conocido como "Error interno del servidor", es uno de los mensajes más temidos al administrar una tienda PrestaShop. Afortunadamente, no siempre es grave y en la mayoría de los casos se puede solucionar siguiendo pasos sencillos.

Cuando ves un error 500 PrestaShop, significa que el servidor web ha encontrado una condición inesperada que le impide completar la solicitud. No te preocupes, esto no siempre indica que tu tienda esté dañada permanentemente.

Las causas más comunes del error 500 en PrestaShop incluyen:

Archivos .htaccess corruptos o mal configurados
Módulos incompatibles o mal instalados
Problemas de permisos en archivos y carpetas
Exceso de memoria PHP (límite superado)
Errores en la configuración del servidor (cPanel o Plesk)
Temas (plantillas) defectuosos o incompatibles

Primeros pasos: identificar el problema antes de actuar

Antes de solucionar error 500 PrestaShop, necesitas saber qué lo está causando. El error 500 es genérico, así que debes buscar más detalles.

Activar el modo debug de PrestaShop

El modo debug te mostrará el error real en lugar de la pantalla blanca o el mensaje genérico.

Sigue estos pasos:

Accede a tu panel de control (cPanel, Plesk o Syspanel).
Ve al administrador de archivos (File Manager).
Localiza el archivo config/defines.inc.php en la raíz de tu instalación de PrestaShop.
Busca la línea: define('_PS_MODE_DEV_', false);
Cámbiala por: define('_PS_MODE_DEV_', true);
Guarda el archivo.

[INFO] Si no encuentras el archivo defines.inc.php, revisa que estés en la carpeta correcta de tu tienda PrestaShop.

Ahora, al recargar tu tienda, verás un mensaje de error detallado con el nombre del archivo y la línea problemática. Anota esa información.

Revisar los logs del servidor

Otra forma de obtener pistas es revisar los logs de error del servidor:

En cPanel:

Ve a "Registros de errores" (Error Logs).
Busca entradas recientes con la fecha y hora del error 500.
Anota la ruta del archivo y el mensaje de error.

En Plesk:

Ve a "Sitios web y dominios".
Selecciona tu dominio.
Haz clic en "Registros" (Logs).
Busca errores del tipo "500 Internal Server Error".

[TIP] Los logs suelen mostrar la línea exacta del código donde ocurre el problema. Esto te ahorrará horas de búsqueda.

Soluciones paso a paso para el error 500 en PrestaShop

1. Restaurar el archivo .htaccess

El archivo .htaccess es uno de los principales culpables del error 500 PrestaShop. Si está corrupto o mal generado, el servidor no puede procesar las reglas de reescritura.

Pasos para restaurarlo:

Accede a tu panel de control (cPanel, Plesk o Syspanel).
Ve al administrador de archivos.
Localiza el archivo .htaccess en la raíz de tu tienda (normalmente en public_html/ o httpdocs/).
Haz una copia de seguridad renombrándolo a .htaccess_backup.
Ahora, elimina el archivo .htaccess original.
Ve al back office de PrestaShop (si puedes acceder).
Ve a "Parámetros de la tienda > Tráfico y SEO > SEO y URLs".
Haz clic en "Guardar" sin cambiar nada. Esto regenerará el archivo .htaccess automáticamente.

[WARNING] Si no puedes acceder al back office, puedes crear un archivo .htaccess básico temporal con solo el contenido mínimo:

# START: PrestaShop
RewriteEngine On
# END: PrestaShop

2. Deshabilitar módulos problemáticos

Los módulos incompatibles o mal codificados son otra causa frecuente. Para deshabilitarlos sin acceso al back office:

Método manual (sin acceso al panel):

Accede a tu base de datos usando phpMyAdmin (desde cPanel o Plesk).
Busca la tabla ps_module (el prefijo puede variar).
Ejecuta la siguiente consulta SQL para desactivar todos los módulos no esenciales:
```
UPDATE ps_module SET active = 0 WHERE id_module > 1;
```
Luego, vuelve a activar los módulos uno por uno desde el back office para identificar el culpable.

Método con acceso al back office:

Ve a "Módulos > Gestor de módulos".
Desactiva los módulos instalados recientemente o aquellos que sospeches.
Si el error desaparece, ese módulo es el problema. Actualízalo o contacta al desarrollador.

3. Aumentar el límite de memoria PHP

PrestaShop necesita suficiente memoria para funcionar. Un límite bajo puede provocar el error 500.

En cPanel:

Ve a "Seleccionar versión de PHP" (o "MultiPHP Manager").
Haz clic en "Opciones" o "Switch to PHP Options".
Busca memory_limit y cámbialo a 256M o 512M.
Guarda los cambios.

En Plesk:

Ve a "Sitios web y dominios".
Selecciona tu dominio y haz clic en "Configuración de PHP".
Busca memory_limit y ajústalo a 256M.
Aplica los cambios.

En Syspanel (HestiaCP):

Accede a Syspanel por el puerto 2106 (ejemplo: https://tudominio.com:2106).
Ve a "Servicios > PHP".
Selecciona la versión de PHP que usa tu sitio.
Busca memory_limit y cámbialo a 256M.
Guarda y reinicia el servicio PHP.

4. Verificar permisos de archivos y carpetas

Los permisos incorrectos pueden impedir que PrestaShop lea o escriba archivos necesarios.

Permisos recomendados:

Carpetas: 755
Archivos: 644
Carpeta config/: 755
Carpeta cache/: 755
Carpeta log/: 755

Cómo cambiarlos en cPanel:

Selecciona todos los archivos y carpetas.
Haz clic en "Permisos" (o "Change Permissions").
Aplica 755 para carpetas y 644 para archivos.

[INFO] Si tienes problemas con la carpeta cache/, puedes vaciarla manualmente (sin borrar la carpeta) eliminando su contenido.

5. Revisar el tema (plantilla) activo

Un tema mal diseñado o incompatible con tu versión de PrestaShop puede causar el error 500.

Para cambiar al tema predeterminado:

Accede a tu base de datos con phpMyAdmin.
Busca la tabla ps_configuration.
Encuentra la fila PS_THEME_NAME y cámbiala a classic (o el nombre del tema por defecto).
Guarda los cambios y recarga tu tienda.

Si el error desaparece, el tema anterior es el problema. Actualízalo o contacta al desarrollador.

6. Verificar la configuración de PHP (max_execution_time y upload_max_filesize)

A veces, el error 500 aparece al intentar subir archivos grandes o al ejecutar procesos largos.

Ajustes recomendados:

max_execution_time: 300 (segundos)
upload_max_filesize: 64M
post_max_size: 64M

Puedes modificar estos valores desde el panel de control, igual que con memory_limit.

Soluciones específicas para cPanel y Plesk

cPanel error 500: pasos adicionales

Verificar el registro de errores de Apache:
- Ve a "Registros de errores" y busca líneas con "500".
- También revisa el archivo error_log en la raíz de tu sitio.
Revisar los límites de recursos:
- En "Múltiples administradores de PHP", comprueba que max_execution_time y memory_limit sean adecuados.
Desactivar módulos de seguridad temporalmente:
- Si tienes módulos como "ModSecurity", desactívalos desde "Seguridad" en cPanel para probar.

Plesk: soluciones específicas

Revisar la configuración de PHP por dominio:
- Ve a "Sitios web y dominios > Configuración de PHP" y asegúrate de que los valores sean correctos.
Verificar los logs de error de Plesk:
- En "Registros", filtra por "500" para encontrar entradas relevantes.
Reiniciar servicios:
- Desde "Herramientas y ajustes > Servicios", reinicia Apache y PHP-FPM.

Preguntas frecuentes (FAQ)

¿Por qué aparece el error 500 después de instalar un módulo?

Es común que módulos mal codificados o incompatibles causen conflictos. Desactívalo desde la base de datos como se explicó antes.

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

Sí, especialmente si la actualización no se completó correctamente o si hay archivos sobrantes. Revisa los logs y asegúrate de que todos los archivos estén actualizados.

¿Cómo puedo evitar el error 500 en el futuro?

Mantén PrestaShop, módulos y temas actualizados.
Realiza copias de seguridad periódicas.
Prueba módulos y temas en un entorno de desarrollo antes de instalarlos en producción.
Aumenta los límites de PHP si tu tienda tiene mucho tráfico.

¿Qué hago si no puedo acceder al back office?

Utiliza las soluciones manuales: restaurar .htaccess, deshabilitar módulos desde la base de datos, cambiar el tema desde phpMyAdmin.

¿El error 500 puede ser por problemas de hosting?

Sí, a veces el servidor tiene problemas de recursos o configuraciones incorrectas. Contacta a tu proveedor de hosting si las soluciones anteriores no funcionan.

Resumen y recomendaciones finales

El error 500 PrestaShop puede parecer abrumador, pero siguiendo estos pasos podrás solucionarlo en la mayoría de los casos. Recuerda:

Siempre haz una copia de seguridad antes de hacer cambios importantes.
Activa el modo debug para obtener información detallada.
Revisa los logs del servidor para identificar la causa exacta.
Prueba una solución a la vez para no complicar el problema.

Si después de intentar todas estas soluciones el error persiste, contacta a tu proveedor de hosting o a un desarrollador especializado en PrestaShop. La mayoría de los errores 500 se resuelven con paciencia y método.

[TIP] Guarda esta guía en tus favoritos para tenerla a mano cuando aparezca el temido error 500. Con práctica, podrás solucionarlo en minutos.