Cómo arreglar error 500 en PrestaShop | Guía rápida

¡Hola! Si estás leyendo esto, seguramente te has topado con la temida pantalla en blanco o el mensaje "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. Este error significa que el servidor web ha encontrado una condición inesperada que le impide completar la solicitud. En este artículo, te guiaré paso a paso para solucionar el error 500 PrestaShop en los paneles de control más populares: cPanel, Plesk y DirectAdmin. También veremos cómo proceder si usas Syspanel (HestiaCP). Vamos a ello.

[INFO] Este artículo está pensado para que lo puedas seguir aunque no seas un experto en hosting. Solo necesitas acceso a tu panel de control y un poco de paciencia.

¿Por qué aparece el error 500 en PrestaShop?

Antes de lanzarnos a las soluciones, es útil entender las causas más comunes. El PrestaShop internal server error puede deberse a:

Problemas de permisos de archivos: PrestaShop necesita permisos específicos para leer y escribir en sus carpetas.
Errores en archivos .htaccess: Una mala configuración de este archivo puede bloquear el acceso a tu tienda.
Módulos o temas incompatibles: Un módulo recién instalado o un tema mal configurado pueden romper la tienda.
Límite de memoria PHP excedido: Si tu tienda consume más memoria de la permitida, el servidor se detiene.
Problemas con la versión de PHP: PrestaShop requiere una versión específica de PHP para funcionar correctamente.
Errores en la base de datos: Aunque menos común, un problema en la base de datos también puede generar un error 500.

Ahora que sabemos qué buscar, veamos cómo solucionar el error 500 PrestaShop en cada panel.

## Solucionar error 500 en PrestaShop con cPanel

cPanel es uno de los paneles más extendidos. Aquí te dejo los pasos para diagnosticar y arreglar el error.

### 1. Activar el modo debug de PrestaShop

El primer paso es obtener más información sobre el error. Para ello, activamos el modo de depuración (debug) de PrestaShop.

Accede a tu cPanel y busca el Administrador de Archivos (File Manager).
Navega hasta la carpeta raíz de tu tienda (normalmente public_html o el nombre de tu dominio).
Busca el archivo config/defines.inc.php.
Haz clic derecho sobre él y selecciona Editar.
Busca la línea que dice: define('_PS_MODE_DEV_', false);
Cámbiala por: define('_PS_MODE_DEV_', true);
Guarda los cambios y cierra el archivo.

Ahora, al recargar tu tienda, en lugar del error 500, verás un mensaje de error más detallado (por ejemplo, "Fatal error: Allowed memory size of..."). Ese mensaje te dará la pista clave.

[TIP] Anota el mensaje de error que ves. Te será útil para los siguientes pasos. Una vez solucionado, vuelve a poner false en esa línea.

### 2. Restaurar el archivo .htaccess

Un archivo .htaccess dañado es una causa muy frecuente del error 500 PrestaShop.

En el Administrador de Archivos, localiza el archivo .htaccess en la raíz de tu tienda.
Si no lo ves, asegúrate de tener marcada la opción Mostrar archivos ocultos (dot files).
Haz clic derecho sobre .htaccess y renómbralo a .htaccess_backup. Esto lo desactivará.
Ahora, accede a tu Panel de Administración de PrestaShop (si es que puedes). Si no puedes, ve al paso 5.
Una vez dentro del panel, ve a Configuración de la tienda > Rendimiento y haz clic en Guardar (sin cambiar nada). Esto regenerará el archivo .htaccess automáticamente.
Si no puedes acceder al panel de administración, deberás generar un .htaccess básico. Puedes pedirle a tu hosting que te ayude o crear uno manualmente con un contenido mínimo (solo para probar). Lo más seguro es restaurar desde una copia de seguridad si la tienes.

### 3. Verificar y cambiar la versión de PHP

PrestaShop necesita una versión de PHP específica (por ejemplo, 7.4 o 8.0, dependiendo de la versión de PrestaShop).

En cPanel, busca la sección Software y haz clic en Seleccionar versión de PHP (o MultiPHP Manager).
En la lista, selecciona la versión de PHP recomendada para tu PrestaShop (consulta la documentación oficial).
Haz clic en Aplicar o Establecer como versión actual.

### 4. Aumentar el límite de memoria PHP

Si el error indica un problema de memoria, puedes aumentarlo.

En el Administrador de Archivos, busca el archivo php.ini en la raíz de tu tienda. Si no existe, puedes crearlo.
Edítalo y añade o modifica la línea: memory_limit = 256M (puedes probar con 128M o 256M).
Guarda los cambios.

[WARNING] Si no encuentras el archivo php.ini, puedes crearlo con un editor de texto. Asegúrate de que tenga el formato correcto. Si tu hosting usa PHP-FPM, es posible que necesites un archivo .user.ini en su lugar.

## Solucionar error 500 en PrestaShop con Plesk

Plesk es otro panel muy común, especialmente en entornos Windows y Linux. El proceso es similar, pero con ligeras diferencias.

### 1. Activar el modo debug (Plesk)

Accede a Plesk y ve a Sitios web y dominios.
Haz clic en Administrador de archivos.
Navega a la carpeta de tu dominio (por ejemplo, httpdocs).
Sigue los mismos pasos que en cPanel para editar config/defines.inc.php y activar _PS_MODE_DEV_.

### 2. Restaurar .htaccess (Plesk)

En el Administrador de archivos de Plesk, localiza el .htaccess en la carpeta httpdocs.
Renómbralo a .htaccess_backup.
Regenera el archivo desde el panel de administración de PrestaShop (si puedes acceder).

### 3. Gestionar versiones de PHP (Plesk)

En Plesk, ve a Sitios web y dominios y selecciona tu dominio.
Busca la sección PHP Settings (o Configuración de PHP).
Aquí puedes seleccionar la versión de PHP y también ajustar el memory_limit directamente desde la interfaz.
Cambia el valor a 256M o el que necesites.

### 4. Verificar permisos de archivos (Plesk)

Los permisos incorrectos pueden causar el error.

En el Administrador de archivos, selecciona toda la carpeta de tu tienda.
Haz clic en Permisos (o Change Permissions).
Asegúrate de que las carpetas tengan permisos 755 y los archivos 644. No uses 777 por seguridad.

## Solucionar error 500 en PrestaShop con DirectAdmin

DirectAdmin es un panel ligero pero potente. Aquí tienes los pasos.

### 1. Activar modo debug (DirectAdmin)

Accede a DirectAdmin y ve a Administrador de archivos.
Navega a la carpeta domains/tudominio.com/public_html (o similar).
Edita config/defines.inc.php como en los casos anteriores.

### 2. Restaurar .htaccess (DirectAdmin)

En el Administrador de archivos, busca .htaccess en la raíz.
Renómbralo a .htaccess_backup.
Regenera desde el panel de administración de PrestaShop.

### 3. Cambiar versión de PHP y límites (DirectAdmin)

En DirectAdmin, ve a Configuración de la cuenta > Versión de PHP.
Selecciona la versión adecuada.
Para ajustar la memoria, necesitas editar el archivo php.ini o usar la opción PHP Settings si está disponible. Busca la línea memory_limit y cámbiala.

### 4. Verificar permisos (DirectAdmin)

Selecciona la carpeta de tu tienda en el Administrador de archivos.
Haz clic en Cambiar permisos.
Pon 755 para carpetas y 644 para archivos.

## Solucionar error 500 en PrestaShop con Syspanel (HestiaCP)

Si tu hosting usa Syspanel (HestiaCP), el proceso es similar, pero ten en cuenta que el puerto de acceso es el 2106.

### 1. Acceder a Syspanel

Abre tu navegador y escribe: https://tudominio.com:2106
Inicia sesión con tus credenciales.

### 2. Activar modo debug (Syspanel)

Ve a Archivos > Administrador de archivos.
Navega a la carpeta web/tudominio.com/public_html.
Edita config/defines.inc.php y activa el modo debug.

### 3. Restaurar .htaccess (Syspanel)

En el Administrador de archivos, busca y renombra .htaccess.
Regenera desde el panel de PrestaShop.

### 4. Cambiar versión de PHP (Syspanel)

En Syspanel, ve a Web > Configuración de PHP.
Selecciona la versión de PHP que necesites.

[INFO] En Syspanel, los límites de memoria suelen configurarse desde el archivo php.ini que se encuentra en la carpeta web/tudominio.com. Puedes editarlo desde el administrador de archivos.

## Otras soluciones generales para el error 500 en PrestaShop

Si los pasos anteriores no funcionan, prueba estas opciones adicionales.

### Desactivar módulos manualmente

Un módulo problemático puede estar causando el error.

Accede a tu tienda por FTP o al administrador de archivos.
Ve a la carpeta modules.
Renombra la carpeta de un módulo sospechoso (por ejemplo, añade _off al final).
Prueba si la tienda funciona. Si sí, ese módulo es el culpable. Repite con otros hasta encontrar el problema.

### Restaurar una copia de seguridad

Si todo falla, restaurar una copia de seguridad reciente es la solución más segura. Contacta a tu hosting si no sabes cómo hacerlo.

### Contactar al soporte técnico

Si después de todo esto el error 500 PrestaShop persiste, no dudes en contactar al soporte de tu hosting. Ellos pueden revisar los logs del servidor y darte una solución más precisa.

## FAQ: Preguntas frecuentes sobre el error 500 en PrestaShop

¿Por qué mi PrestaShop da error 500 después de instalar un módulo?

Es muy común. El módulo puede ser incompatible con tu versión de PrestaShop o consumir demasiados recursos. Desactívalo manualmente renombrando su carpeta en modules.

¿El error 500 puede deberse a un problema de mi hosting?

Sí, a veces el problema es del servidor (por ejemplo, un error de configuración o una sobrecarga). Revisa los logs del servidor o contacta a tu hosting.

¿Cómo puedo ver los logs de error de mi servidor?

En cPanel, busca Logs de errores en la sección Métricas. En Plesk, ve a Sitios web y dominios > Logs. En DirectAdmin, busca Error Log en Configuración avanzada. En Syspanel, los logs suelen estar en /var/log/.

¿Qué hago si no puedo acceder al panel de administración de PrestaShop?

Puedes solucionar el error 500 desde el administrador de archivos de tu panel de control. Sigue los pasos descritos para desactivar módulos, regenerar .htaccess o cambiar la versión de PHP.

[WARNING] Siempre haz una copia de seguridad de tu tienda antes de hacer cambios importantes. Así podrás revertir cualquier problema.

Espero que esta guía te haya sido de gran ayuda. Recuerda que la paciencia es clave y que, paso a paso, podrás solucionar error 500 PrestaShop y tener tu tienda funcionando de nuevo. ¡Mucho ánimo!