Solucionar error 500 en PrestaShop | Causas y pasos

¿Qué es exactamente el error 500 en PrestaShop?

El error 500, también conocido como PrestaShop error interno, es un mensaje genérico que indica que algo salió mal en el servidor, pero sin dar detalles específicos. Es como si tu tienda te dijera: "Algo no funciona, pero no sé decirte exactamente qué". Afortunadamente, la mayoría de las veces tiene solución y no implica que hayas perdido datos.

Cuando ves una pantalla en blanco o un mensaje como "Error interno del servidor", lo primero es no alarmarse. Este error puede aparecer por muchas razones: un plugin incompatible, un archivo PHP con permisos incorrectos, un límite de memoria excedido o incluso un problema temporal del hosting.

Causas más comunes del error 500 PrestaShop

Antes de lanzarte a solucionar, es útil entender qué puede estar provocando el problema. Estas son las causas más frecuentes:

1. Módulos o temas incompatibles

Al instalar un módulo nuevo o actualizar uno existente, puede que entre en conflicto con la versión de PrestaShop que tienes. Lo mismo ocurre con los temas.

2. Archivos .htaccess corruptos o mal configurados

El archivo .htaccess controla las reglas de reescritura de URL. Si se daña, el servidor no sabe cómo interpretar las peticiones.

3. Límite de memoria PHP (memory_limit) insuficiente

PrestaShop necesita un mínimo de memoria para funcionar. Si tu tienda tiene muchos productos o módulos pesados, puede superar el límite.

4. Permisos de archivos incorrectos

Los archivos y carpetas de PrestaShop deben tener permisos específicos. Si están mal asignados, el servidor no puede leerlos o escribirlos.

5. Problemas con el archivo settings.inc.php

Este archivo contiene la configuración de la base de datos. Si se corrompe o tiene datos incorrectos, la tienda no arranca.

6. Errores de PHP (sintaxis, funciones obsoletas)

Si un archivo PHP tiene un error de escritura o usa una función que ya no existe, el servidor lanza un error 500.

Paso 1: Activar el modo debug de PrestaShop

Lo primero que necesitas es obtener más información sobre el error. El modo debug de PrestaShop te mostrará el mensaje exacto de error.

Cómo activar el modo debug:

Accede a tu hosting por FTP (FileZilla, por ejemplo) o al panel de archivos de tu hosting.
Busca el archivo config/defines.inc.php en la raíz de tu instalación de PrestaShop.
Descarga una copia de seguridad por si algo sale mal.
Abre el archivo 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.

[INFO] Si no encuentras el archivo, puede que esté en una subcarpeta. Asegúrate de buscar en [tu-dominio]/config/defines.inc.php.

Ahora, al recargar tu tienda, verás un mensaje de error detallado con el archivo y la línea exacta donde falla. Anota esa información para los pasos siguientes.

Paso 2: Solucionar el error según el mensaje

Dependiendo de lo que veas en pantalla, el enfoque varía. Aquí tienes las soluciones más habituales:

Si el error dice "Allowed memory size of X bytes exhausted"

Esto significa que tu tienda necesita más memoria de la que tiene asignada.

Cómo arreglarlo:

Accede al panel de control de tu hosting (cPanel, Syspanel, etc.).
Busca la sección de "PHP Settings" o "Selector de PHP".
Aumenta el valor de memory_limit a 256M o 512M. Si no tienes acceso, contacta con tu proveedor.
Guarda los cambios y recarga la tienda.

[WARNING] Si usas Syspanel (antes HestiaCP), el acceso es por el puerto 2106. Busca la opción "PHP Config" dentro del dominio de tu tienda.

Si el error menciona un archivo .htaccess

El archivo .htaccess puede estar corrupto. La solución más rápida es regenerarlo.

Pasos:

Conéctate por FTP y localiza el archivo .htaccess en la raíz de tu PrestaShop.
Renómbralo a .htaccess_old (esto lo desactiva temporalmente).
Ve al panel de administración de PrestaShop (si aún puedes acceder).
Ve a Configuración → Parámetros generales → SEO y URLs.
Haz clic en "Guardar" sin cambiar nada. Esto regenera el .htaccess automáticamente.
Si no puedes acceder al panel, crea un archivo .htaccess nuevo con contenido básico:

# Regenera este archivo desde el panel de PrestaShop

Luego, desde el panel de administración, guárdalo de nuevo.

Si el error menciona un módulo o tema específico

El problema es probablemente un módulo o tema que no es compatible.

Cómo solucionarlo:

Conéctate por FTP a tu servidor.
Ve a la carpeta modules/ y localiza la carpeta del módulo que aparece en el error.
Renómbrala añadiendo un guion bajo al final, por ejemplo: mimodulo_. Esto lo desactiva.
Recarga tu tienda. Si el error desaparece, ya sabes qué módulo es.
Si el error menciona un tema, ve a la carpeta themes/ y renombra la carpeta del tema activo. PrestaShop usará el tema por defecto (por ejemplo, "classic").

[TIP] Si no sabes qué módulo desactivar, renombra todos los módulos de uno en uno hasta encontrar el culpable. Es tedioso pero efectivo.

Paso 3: Verificar permisos de archivos y carpetas

Los permisos incorrectos son una causa frecuente del error 500 PrestaShop.

Los permisos correctos son:

Archivos: 644
Carpetas: 755
Archivo config/settings.inc.php: 644 (o 640 en algunos servidores)

Cómo cambiarlos:

Conéctate por FTP.
Selecciona toda la carpeta de PrestaShop.
Haz clic derecho y elige "Permisos de archivo" o "File Permissions".
Marca las opciones:
- Archivos: 644 (lectura y escritura para el usuario, solo lectura para grupo y otros)
- Carpetas: 755 (lectura y ejecución para todos, escritura solo para el usuario)
Aplica los cambios a todas las subcarpetas y archivos.

[WARNING] No pongas permisos 777 a menos que sea estrictamente necesario y solo temporalmente. Es un riesgo de seguridad.

Paso 4: Revisar el archivo settings.inc.php

Este archivo contiene la conexión a la base de datos. Si está dañado, tu tienda no funciona.

Cómo verificarlo:

Abre el archivo config/settings.inc.php con un editor de texto.

Busca estas líneas:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_base_datos');
define('_DB_USER_', 'usuario_base_datos');
define('_DB_PASSWD_', 'contraseña_base_datos');

Asegúrate de que los datos sean correctos. Si no los recuerdas, pídelos a tu hosting.
Si el archivo está vacío o corrupto, restáuralo desde una copia de seguridad.

Paso 5: Incrementar el límite de memoria desde PHP

Si no puedes acceder al panel de control, puedes hacerlo manualmente.

Opción A: Editar el archivo php.ini

Busca o crea un archivo php.ini en la raíz de tu PrestaShop.
Añade esta línea:
```
memory_limit = 256M
```
Guarda y sube el archivo.

Opción B: Usar un archivo .user.ini

Si tu hosting usa PHP-FPM, crea un archivo .user.ini en la raíz con el mismo contenido.

Opción C: Desde el archivo .htaccess

Añade esta línea al final de tu .htaccess:

php_value memory_limit 256M

[INFO] No todos los hostings permiten sobrescribir la configuración de PHP desde .htaccess. Si no funciona, contacta con soporte.

Paso 6: Deshabilitar todos los módulos no esenciales

A veces, un módulo conflictivo no se muestra en el error. Desactivarlos todos es una buena prueba.

Cómo hacerlo desde FTP:

Ve a la carpeta modules/ de tu PrestaShop.
Renombra la carpeta de cada módulo que no sea esencial (por ejemplo, añade _off al final).
Deja solo los módulos básicos: ps_mainmenu, ps_searchbar, etc.
Recarga la tienda. Si funciona, reactiva los módulos de uno en uno hasta encontrar el problema.

Si tienes acceso al panel de administración, ve a Módulos → Módulos instalados y desactívalos desde allí.

Paso 7: Verificar la versión de PHP

PrestaShop requiere una versión específica de PHP. Si tu hosting la ha actualizado o cambiado, puede haber incompatibilidades.

Versiones recomendadas:

PrestaShop 1.6: PHP 5.6 o 7.0
PrestaShop 1.7: PHP 7.1 a 7.4
PrestaShop 8: PHP 7.4 u 8.0

Cómo cambiarla:

Accede al panel de control de tu hosting.
Busca "PHP Version Manager" o "Selector de PHP".
Elige la versión adecuada para tu PrestaShop.
Guarda y recarga.

[WARNING] Si usas Syspanel, ve a la sección de tu dominio y busca "PHP Version". El puerto de acceso es el 2106.

Preguntas frecuentes (FAQ)

¿Puedo perder datos al solucionar el error 500?

No. El error 500 es un problema de configuración o de archivos, no de base de datos. Tus productos, clientes y pedidos están a salvo.

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

No te preocupes. Puedes solucionar casi todo desde FTP o el panel de control de tu hosting. Sigue los pasos de esta guía.

¿El error 500 puede deberse a un ataque?

Es posible, pero poco común. Si sospechas, cambia todas las contraseñas y verifica que no haya archivos extraños en tu instalación.

¿Debo contratar a un experto?

Si después de seguir todos los pasos el error persiste, puede ser un problema más profundo del servidor. En ese caso, contacta con el soporte técnico de tu hosting o con un desarrollador especializado en PrestaShop.

¿Cada cuánto debo hacer copias de seguridad?

Idealmente, cada vez que hagas cambios importantes (actualizaciones, nuevos módulos, cambios de tema). También es recomendable tener copias automáticas semanales.

Conclusión

El error 500 PrestaShop puede ser frustrante, pero con esta guía paso a paso tienes todas las herramientas para solucionar error 500 PrestaShop por ti mismo. Recuerda: activa el modo debug, verifica permisos, revisa módulos y ajusta la memoria PHP. En la mayoría de los casos, el problema se resuelve en minutos.

Si todo falla, no dudes en pedir ayuda profesional. Pero antes, respira hondo y repasa cada paso. ¡Tu tienda volverá a funcionar!