Error 500 en PrestaShop: causas y soluciones detalladas

¿Tu tienda PrestaShop muestra una pantalla en blanco o un mensaje de error 500? No te preocupes, es uno de los problemas más comunes en PrestaShop y, por suerte, casi siempre tiene solución.

El error 500 PrestaShop (también conocido como "Internal Server Error") es un código de error genérico del servidor. Significa que algo salió mal en el servidor web al intentar cargar tu tienda, pero no especifica exactamente qué. Por eso, solucionarlo requiere un proceso de prueba y error, pero siguiendo los pasos adecuados, podrás identificar y resolver la causa.

En esta guía paso a paso, te explicaré cómo solucionar error 500 PrestaShop de forma segura, incluso si no eres un experto técnico.

¿Qué causa el error 500 en PrestaShop?

Antes de empezar, es útil saber qué suele provocar este error. Las causas más frecuentes incluyen:

Archivos .htaccess corruptos o mal configurados. Es el archivo que gestiona las reglas de reescritura de URL y redirecciones.
Módulos incompatibles o dañados. Un módulo recién instalado o actualizado puede generar conflictos.
Problemas de memoria PHP. Cuando un script consume más memoria de la permitida por el servidor.
Archivos de caché corruptos. La caché de PrestaShop puede dañarse y causar errores.
Permisos de archivos incorrectos. Si los archivos o carpetas de PrestaShop tienen permisos demasiado restrictivos o demasiado abiertos.
Problemas con el tema (plantilla). Un tema mal diseñado o incompatible con tu versión de PrestaShop.
Errores en el archivo settings.inc.php. Este archivo contiene la configuración de la base de datos y puede corromperse.

Requisitos previos y precauciones

Antes de manipular archivos, es fundamental que tomes algunas precauciones para no empeorar el problema o perder datos.

[WARNING] Haz siempre una copia de seguridad completa de tu tienda (archivos y base de datos) antes de realizar cualquier cambio. Así, si algo sale mal, podrás restaurar tu tienda al estado anterior.

Necesitarás acceso a dos herramientas:

Acceso al panel de control de tu hosting (cPanel, Syspanel, etc.). Para acceder a los archivos de tu tienda mediante el Administrador de Archivos o un cliente FTP (como FileZilla).
Acceso a phpMyAdmin (o similar). Para gestionar la base de datos de PrestaShop, si es necesario.

[INFO] Si tu hosting usa Syspanel (HestiaCP), accede a través del puerto 2106 (ejemplo: tudominio.com:2106). Allí encontrarás el Administrador de Archivos y phpMyAdmin.

Paso 1: Activar el modo de depuración de PrestaShop

El primer paso para solucionar error 500 PrestaShop es obtener más información sobre el error. PrestaShop tiene un modo de depuración que muestra el mensaje de error real en lugar de la pantalla en blanco.

¿Cómo activar el modo debug?

Accede a los archivos de tu tienda mediante FTP o el Administrador de Archivos de tu hosting.
Busca el archivo config/defines.inc.php dentro de la carpeta raíz de PrestaShop.
Ábrelo con un editor de texto (como el Bloc de notas o el editor del panel de control).
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 (si lo editaste localmente).

Ahora, al cargar tu tienda, en lugar del error 500, verás un mensaje de error detallado. Ese mensaje te indicará el archivo y la línea exacta donde se produce el problema. ¡Anota ese error!

[TIP] Si no ves ningún mensaje, puede que el error sea muy grave. En ese caso, revisa los logs de error del servidor (Paso 3).

Paso 2: Regenerar el archivo .htaccess

El archivo .htaccess es una causa muy común del PrestaShop internal server error. Regenerarlo es sencillo y a menudo resuelve el problema.

Accede a los archivos de tu tienda por FTP.
Busca el archivo .htaccess en la raíz de tu instalación de PrestaShop (donde están las carpetas admin, config, img, etc.).
Renómbralo a algo como .htaccess_old o .htaccess.backup. Esto lo desactivará temporalmente.
Ahora, ve al panel de administración de tu tienda PrestaShop (si puedes acceder). Si no puedes acceder, salta al método alternativo.
Ve a Configuración de la tienda > Tráfico y SEO > SEO y URLs.
Sin cambiar nada, haz clic en el botón Guardar en la parte inferior. Esto regenerará automáticamente el archivo .htaccess con las reglas correctas.

¿No puedes acceder al panel de administración? No te preocupes. Simplemente, después de renombrar el archivo .htaccess, intenta cargar tu tienda. Si el error 500 desaparece, el problema era el .htaccess. Puedes intentar crear uno nuevo manualmente (buscando el contenido por defecto para tu versión de PrestaShop) o restaurar el backup que renombraste.

Paso 3: Revisar los logs de error del servidor

Los logs de error son el diario del servidor. Allí se registran todos los errores, incluyendo el error 500 PrestaShop. Acceder a ellos te dará pistas muy valiosas.

Acceder a los logs:

En cPanel: Busca la sección "Logs de errores" o "Error Log" dentro de la sección de métricas o software.
En Syspanel (HestiaCP): Ve a "Logs" en el menú principal y luego selecciona "Error Log" o "Web Log". Generalmente, los errores de PHP y Apache se encuentran en /var/log/apache2/error.log o similar, pero desde el panel puedes verlos fácilmente.
Por FTP: A veces los logs están en una carpeta llamada logs o error_log en la raíz de tu cuenta de hosting.

Busca las líneas que coincidan con la hora en que viste el error. El mensaje suele ser algo como: PHP Fatal error: Allowed memory size of X bytes exhausted... o PHP Fatal error: Uncaught Error: Class 'X' not found.... Este mensaje es oro puro para la solución.

Paso 4: Aumentar el límite de memoria PHP

Un error muy común es que un script de PrestaShop (por ejemplo, al procesar un módulo o una imagen grande) supere el límite de memoria permitido. Esto provoca un error 500 PrestaShop.

Para solucionarlo, debes aumentar el límite de memoria PHP. Hay varias formas de hacerlo:

Opción A: Desde el archivo .htaccess (recomendado)

Accede al archivo .htaccess (el que regeneraste o el original).
Añade esta línea al final del archivo:
php_value memory_limit 256M
(Puedes probar con 128M o 512M si es necesario).
Guarda el archivo.

Opción B: Desde el archivo php.ini

Busca un archivo llamado php.ini en la raíz de tu hosting (a veces está en una carpeta superior).
Si no existe, puedes crearlo.
Añade la línea:
memory_limit = 256M

Opción C: Desde el panel de control del hosting

cPanel: Busca la sección "Seleccionar versión de PHP" o "Configuración de PHP". Allí podrás ajustar el valor de memory_limit desde una interfaz gráfica.
Syspanel (HestiaCP): Ve a "Configuración del servidor" o "PHP", selecciona tu sitio web y modifica el valor de memory_limit en la lista de opciones.

[WARNING] No aumentes la memoria sin límite. 256M es un valor seguro para la mayoría de tiendas. Si necesitas más, consulta con tu proveedor de hosting.

Paso 5: Deshabilitar módulos problemáticos

Los módulos son una causa frecuente de conflictos. Si el error 500 apareció después de instalar o actualizar un módulo, ese es el principal sospechoso.

¿Cómo deshabilitar módulos si no puedes acceder al panel de administración?

Accede a tu base de datos mediante phpMyAdmin (desde cPanel o Syspanel).
Selecciona la base de datos de tu tienda PrestaShop.
Busca la tabla ps_modules (el prefijo ps_ puede variar si lo cambiaste durante la instalación).
Haz clic en Examinar (o Browse) para ver los módulos instalados.
Busca el módulo sospechoso (por ejemplo, el último que instalaste). Haz clic en Editar (el icono del lápiz) en la fila correspondiente.
Cambia el valor de la columna active de 1 a 0. Esto lo desactivará.
Guarda los cambios y recarga tu tienda.

[TIP] Si no sabes qué módulo es el problemático, puedes desactivar todos los módulos no esenciales (todos excepto los de la propia PrestaShop, como "ps_mainmenu", "ps_searchbar", etc.).

Paso 6: Limpiar la caché de PrestaShop

La caché de PrestaShop puede corromperse y causar errores extraños, incluido el error 500 PrestaShop. Limpiarla es muy sencillo.

Método 1: Desde el panel de administración (si puedes acceder)

Ve a Configuración avanzada > Rendimiento y haz clic en el botón "Limpiar caché" (o "Clear cache").

Método 2: Manualmente (recomendado si no puedes acceder)

Accede a los archivos de tu tienda por FTP.
Elimina todo el contenido de la carpeta /var/cache/ (o /cache/ en versiones antiguas). No elimines la carpeta en sí, solo su contenido.
También puedes eliminar el contenido de las carpetas dentro de /var/cache/, como dev, prod, sandbox, etc.

Paso 7: Verificar los permisos de archivos y carpetas

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

Los permisos correctos para PrestaShop son:

Carpetas: 755 (rwxr-xr-x)
Archivos: 644 (rw-r--r--)

Cómo cambiarlos:

Desde un cliente FTP (FileZilla): Selecciona todos los archivos y carpetas de la raíz de tu tienda. Haz clic derecho y selecciona "Permisos de archivo" o "File permissions". Marca las casillas correspondientes (Lectura, Escritura, Ejecución) para el propietario, el grupo y otros. Es más fácil usar un comando desde el panel de control.
Desde el Administrador de Archivos de cPanel/Syspanel: Muchos paneles tienen una opción para cambiar permisos de forma masiva. Busca la opción "Cambiar permisos" o "Change permissions" después de seleccionar los archivos.
Comando SSH (si tienes acceso): Es la forma más rápida. Conéctate por SSH a tu servidor y ejecuta:
find /ruta/a/tu/tienda -type d -exec chmod 755 {} \;
find /ruta/a/tu/tienda -type f -exec chmod 644 {} \;

Paso 8: Comprobar el archivo settings.inc.php

El archivo config/settings.inc.php contiene la configuración de conexión a la base de datos. Si está dañado o tiene errores, PrestaShop no puede funcionar.

Accede al archivo config/settings.inc.php.
Ábrelo con un editor de texto.
Verifica que las líneas _DB_SERVER_, _DB_NAME_, _DB_USER_ y _DB_PASSWD_ tengan los valores correctos de tu base de datos. Si no estás seguro, puedes obtenerlos desde el panel de control de tu hosting (en la sección de bases de datos MySQL).
Si el archivo está vacío o corrupto, puedes restaurarlo desde una copia de seguridad o crearlo de nuevo desde el asistente de instalación de PrestaShop (pero esto último puede ser complejo).

Preguntas Frecuentes (FAQ)

¿Qué hago si después de seguir todos los pasos el error 500 persiste?

Si has agotado todas las opciones, es probable que el problema sea más complejo. Te recomendamos:

Contactar a tu proveedor de hosting. Puede ser un problema a nivel de servidor (configuración de PHP, Apache, etc.).
Revisar los logs del servidor nuevamente. Busca errores más específicos.
Restaurar una copia de seguridad completa de tu tienda (archivos y base de datos) de antes de que apareciera el error.

¿El error 500 puede deberse a un ataque o malware?

Sí, es posible. Si tu tienda ha sido hackeada, los archivos pueden haber sido modificados para redirigir tráfico o mostrar contenido malicioso, lo que puede causar un error 500. Si sospechas de un ataque, escanea tu tienda con un plugin de seguridad o contacta a un experto.

¿Debo actualizar PrestaShop a la última versión para solucionar el error 500?

No necesariamente. Actualizar puede resolver algunos problemas, pero también puede introducir nuevos conflictos si tienes módulos o temas incompatibles. Es mejor diagnosticar la causa específica del error antes de actualizar. Si decides actualizar, haz siempre una copia de seguridad completa primero.

¿Qué significa el error "PrestaShop internal server error" en el log?

Es exactamente lo mismo que el error 500. El servidor web (Apache o Nginx) no pudo procesar la solicitud y devolvió ese código de estado. La causa puede ser cualquiera de las mencionadas en esta guía.

Recuerda: la paciencia y la metodología son clave. Sigue los pasos en orden, y lo más probable es que puedas solucionar error 500 PrestaShop y tener tu tienda funcionando de nuevo en poco tiempo.