Error 500 en PrestaShop: Causas y soluciones

¿Te has encontrado con la temida pantalla en blanco o el mensaje "500 Internal Server Error" en tu tienda PrestaShop? No te preocupes, es uno de los error 500 PrestaShop más comunes y, por suerte, casi siempre tiene solución. En esta guía vamos a desglosar paso a paso cómo diagnosticar y solucionar error 500 en tu tienda online, incluso si no eres un experto en sistemas.

Este error significa que el servidor encontró un problema interno y no pudo completar tu solicitud. Puede aparecer al navegar por el front-office, al acceder al back-office o incluso al instalar un módulo. Vamos a ver las causas más frecuentes y cómo resolverlas una por una.

¿Por qué aparece el error 500 en PrestaShop?

Antes de lanzarnos a las soluciones, es importante entender las causas más habituales. El error servidor PrestaShop puede deberse a:

Problemas de permisos de archivos y carpetas.
Un módulo o tema defectuoso o incompatible.
Límites de memoria PHP excedidos.
Archivos .htaccess corruptos o mal configurados.
Problemas con la versión de PHP o extensiones faltantes.
Errores en el archivo de configuración config/defines.inc.php.

[INFO] El error 500 es un error genérico del servidor. Para saber exactamente qué ocurre, necesitas activar los logs de error de PrestaShop o revisar los logs del servidor.

Primer paso: Activar la visualización de errores en PrestaShop

Por defecto, PrestaShop oculta los errores detallados para no mostrar información sensible a los visitantes. Pero para PrestaShop troubleshooting, necesitas ver el mensaje exacto.

### Accede al archivo de configuración

Conéctate a tu servidor vía FTP o al administrador de archivos de tu panel de control (cPanel, Syspanel, etc.).
Busca la carpeta raíz de tu tienda PrestaShop.
Localiza el archivo config/defines.inc.php.

### Edita el archivo

Descarga una copia de seguridad del archivo por si acaso.
Ábrelo con un editor de texto (Bloc de notas, Sublime Text, etc.).
Busca la línea que dice:

define('_PS_MODE_DEV_', false);

Cámbiala por:

define('_PS_MODE_DEV_', true);

Guarda el archivo y súbelo de nuevo al servidor (sobrescribe el original).

Ahora, cuando recargues la página que daba el error, verás un mensaje más descriptivo como "Fatal error: Allowed memory size exhausted" o "Class not found". Eso te dará una pista clave.

[WARNING] No dejes el modo desarrollo activado en una tienda en producción, ya que muestra información sensible. Una vez resuelto el error, vuelve a poner false.

Segundo paso: Revisar los límites de memoria PHP

Uno de los error 500 PrestaShop más frecuentes es por falta de memoria. PrestaShop es una plataforma exigente, especialmente si tienes muchos módulos o productos.

### Solución desde el archivo php.ini (recomendado)

Accede a tu panel de control (por ejemplo, Syspanel en el puerto 2106).
Busca la sección de "PHP Settings" o "PHP Configuration".
Aumenta los siguientes valores:
- memory_limit a 256M o 512M.
- max_execution_time a 120 o 180.
- upload_max_filesize a 64M.
- post_max_size a 64M.
Guarda los cambios y reinicia el servicio PHP si es necesario.

### Solución desde .htaccess (alternativa)

Si no puedes acceder a php.ini, puedes añadir estas líneas al archivo .htaccess de la raíz de tu tienda:

php_value memory_limit 256M
php_value max_execution_time 180

Guarda y prueba de nuevo.

[TIP] Si usas Syspanel, todo esto se gestiona desde la interfaz web en el puerto 2106, sin necesidad de editar archivos manualmente.

Tercer paso: Verificar y corregir permisos de archivos

Los permisos incorrectos son otra causa común de error servidor PrestaShop. Las carpetas deben tener permisos 755 y los archivos 644.

### Cómo corregirlos

Conéctate por FTP o al administrador de archivos.
Selecciona toda la carpeta de tu tienda.
Busca la opción "Cambiar permisos" o "CHMOD".
Establece:
- Carpetas: 755 (rwxr-xr-x)
- Archivos: 644 (rw-r--r--)
Si tu panel tiene opción "Recursivo", actívala para que se aplique a todas las subcarpetas.

[INFO] Algunos archivos específicos como config/settings.inc.php pueden necesitar permisos 444 o 440 por seguridad. No los toques si no es necesario.

Cuarto paso: Desactivar módulos problemáticos

Un módulo recién instalado o actualizado puede estar causando el conflicto. Si no puedes acceder al back-office, tendrás que hacerlo manualmente.

### Desde la base de datos (más técnico)

Accede a phpMyAdmin (desde Syspanel o cPanel).
Selecciona la base de datos de tu PrestaShop.
Busca la tabla ps_module (el prefijo puede variar, por ejemplo ps_).
Busca el módulo problemático y cambia su estado de 1 a 0 (activo a inactivo).
Otra opción: renombrar la carpeta del módulo sospechoso en /modules/ (por ejemplo, de micromodulo a micromodulo_bak). Esto lo desactiva automáticamente.

### Desde el back-office (si puedes acceder)

Ve a "Módulos" > "Gestor de módulos".
Desactiva los módulos no esenciales o los que hayas instalado recientemente.
Si el error desaparece, ya sabes cuál es el culpable.

[WARNING] Si sospechas de un tema, cambia temporalmente al tema predeterminado (por ejemplo, "classic" en PrestaShop 1.7). Puedes hacerlo desde la base de datos en la tabla ps_configuration, buscando PS_THEME_NAME.

Quinto paso: Regenerar el archivo .htaccess

Un archivo .htaccess corrupto puede provocar errores 500. Es fácil de regenerar.

### Pasos para regenerarlo

Conéctate por FTP y localiza el archivo .htaccess en la raíz de tu tienda.
Renómbralo a .htaccess_bak (no lo borres, por si acaso).
Ve al back-office de PrestaShop (si puedes acceder).
Ve a "Parámetros de la tienda" > "Tráfico y SEO".
En la sección "URLs amigables", haz clic en "Guardar" sin cambiar nada. Esto regenera el archivo.
Si no puedes acceder al back-office, crea un .htaccess vacío y luego desde la base de datos ejecuta esta consulta (con phpMyAdmin):

UPDATE ps_configuration SET value = '0' WHERE name = 'PS_HTACCESS_ACTIVE';

Luego, desde el back-office, vuelve a guardar la configuración de URLs amigables.

[TIP] Si usas Syspanel, puedes regenerar el .htaccess desde la sección de "Apache" o "Configuración del sitio".

Sexto paso: Comprobar la versión de PHP

PrestaShop requiere una versión de PHP específica. Si tu servidor tiene una versión muy antigua o muy nueva, pueden aparecer errores.

### Versiones recomendadas

PrestaShop 1.6: PHP 5.6 a 7.1 (mejor 7.0).
PrestaShop 1.7: PHP 7.1 a 7.4 (mejor 7.3 o 7.4).
PrestaShop 8.x: PHP 8.0 o 8.1.

### Cómo cambiar la versión

En tu panel de control (Syspanel, cPanel, etc.), busca "PHP Selector" o "Cambiar versión de PHP".
Selecciona la versión adecuada para tu PrestaShop.
Guarda los cambios.

[WARNING] Cambiar la versión de PHP puede romper módulos antiguos. Hazlo con cuidado y prueba en un entorno de pruebas si es posible.

Séptimo paso: Revisar los logs del servidor

Si nada de lo anterior funciona, los logs del servidor son tu mejor amigo. Te dirán exactamente qué está fallando.

### Dónde encontrar los logs

En cPanel: "Errores" > "Registro de errores".
En Syspanel: Ve a la sección "Logs" o "Registros" del dominio específico (puerto 2106).
Por SSH: Ejecuta tail -f /var/log/apache2/error.log o tail -f /var/log/nginx/error.log.

Busca líneas que contengan "PHP Fatal error" o "PrestaShop". Allí verás el archivo y la línea exacta del problema.

[INFO] Si ves errores como "require_once(): Failed opening required", es un archivo faltante. Si ves "Call to undefined function", es una extensión PHP que falta (por ejemplo, curl, gd, mbstring).

Preguntas frecuentes (FAQ)

¿Puedo evitar el error 500 en el futuro?

Sí, siguiendo estas buenas prácticas:

Mantén PrestaShop, módulos y temas actualizados.
Haz copias de seguridad frecuentes.
Prueba módulos en un entorno de pruebas antes de instalarlos en producción.
No superes los límites de recursos de tu hosting.

¿Qué hago si el error persiste después de todo?

Si has seguido todos los pasos y el error continúa, puede ser un problema del servidor. Contacta con tu proveedor de hosting y diles que has hecho PrestaShop troubleshooting básico. Proporciónales los logs de error para que puedan ayudarte más rápido.

¿El error 500 afecta al SEO?

Sí, si el error es recurrente, Google puede penalizar tu tienda porque no puede indexar tus páginas. Es importante solucionarlo cuanto antes. Además, los clientes no podrán comprar, lo que afecta a tus ventas.

¿Puedo usar el modo mantenimiento mientras soluciono el error?

Sí, si tienes acceso al back-office, activa el modo mantenimiento en "Parámetros de la tienda" > "Mantenimiento". Así los visitantes verán un mensaje amigable en lugar del error 500.

Conclusión

El error 500 PrestaShop puede parecer aterrador, pero en la mayoría de los casos se soluciona con unos pocos pasos metódicos. Desde activar el modo desarrollo para ver el error exacto, hasta revisar permisos, memoria, módulos o la versión de PHP. Recuerda siempre hacer una copia de seguridad antes de hacer cambios importantes.

Si utilizas Syspanel (accesible en el puerto 2106), muchas de estas configuraciones están disponibles desde su interfaz gráfica, lo que simplifica el proceso. Y si todo falla, no dudes en pedir ayuda a tu hosting o a un desarrollador especializado.

Esperamos que esta guía te haya sido útil. ¡Ahora ya sabes cómo solucionar error 500 en tu tienda PrestaShop y mantenerla funcionando sin problemas!