Solucionar errores 500 en PrestaShop (guía paso a paso)

¿Te ha aparecido de repente la temida pantalla blanca o un mensaje de "Error interno del servidor" en tu tienda PrestaShop? No te preocupes, es una de las situaciones más comunes y, por suerte, una de las más fáciles de solucionar si sabes por dónde empezar. El error 500 PrestaShop es un error genérico que indica que algo ha fallado en el servidor, pero no te da muchos detalles. En esta guía paso a paso, te voy a enseñar a solucionar error 500 PrestaShop sin necesidad de ser un experto en programación. Vamos a ello.

¿Qué es exactamente un error 500 en PrestaShop?

Un PrestaShop error interno (error 500) significa que el servidor web (Apache, Nginx, etc.) ha encontrado una condición inesperada que le impide completar la solicitud. Es como cuando tu coche se para sin motivo aparente: el problema puede estar en el motor, en la gasolina o en un cable suelto. En el caso de PrestaShop, las causas más frecuentes son:

• Un módulo o plugin defectuoso.
• Un tema incompatible o mal configurado.
• Problemas de memoria (límite de memoria PHP excedido).
• Errores de sintaxis en archivos (por ejemplo, después de una actualización).
• Permisos de archivos incorrectos.

[INFO] El error 500 es un "error genérico". No te asustes: rara vez es culpa de tus productos o de tu base de datos. Casi siempre se soluciona desactivando algo que está causando el conflicto.

Primeros pasos: Activar el modo debug de PrestaShop

Lo primero que necesitas es que PrestaShop te cuente qué está fallando exactamente. Por defecto, el error 500 muestra una pantalla en blanco. Para obtener más información, debemos activar el modo de depuración (debug).

Paso 1: Accede a tu servidor por FTP o cPanel

Necesitas un cliente FTP (como FileZilla) o el administrador de archivos de tu panel de control (por ejemplo, Syspanel, que se accede por el puerto 2106). Busca la carpeta raíz de tu tienda PrestaShop (normalmente public_html o www).

Paso 2: Edita el archivo config/defines.inc.php

Localiza el archivo defines.inc.php dentro de la carpeta config. Ábrelo con un editor de texto (Bloc de notas o similar). Busca esta línea:

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.

[WARNING] No dejes el modo debug activado en producción. Una vez solucionado el error, vuelve a cambiarlo a false. Si lo dejas activo, cualquiera podrá ver información sensible de tu servidor.

Paso 3: Recarga tu tienda

Ahora, al acceder a tu web, en lugar de la pantalla en blanco, verás un mensaje de error detallado. Por ejemplo:

• "Fatal error: Call to undefined function..."
• "Allowed memory size of X bytes exhausted..."
• "Parse error: syntax error, unexpected..."

Anota ese mensaje. Te servirá para saber exactamente qué archivo o módulo está causando el problema.

Causas comunes y cómo solucionarlas

1. Módulo o plugin defectuoso

Es la causa más habitual. Un módulo recién instalado o actualizado puede ser incompatible con tu versión de PrestaShop.

Solución paso a paso:

1. Desactiva todos los módulos no esenciales desde el panel de administración de PrestaShop. Si no puedes acceder al panel (porque el error 500 te lo impide), hazlo manualmente.
2. Desactiva módulos por FTP: Ve a la carpeta /modules y renombra la carpeta del módulo sospechoso añadiendo un guion bajo al final (por ejemplo, micodigo → micodigo_). Esto lo desactivará.
3. Prueba a recargar la web. Si el error desaparece, ese módulo es el culpable. Puedes eliminarlo o buscar una versión compatible.
4. Si no sabes cuál es, renombra todas las carpetas de módulos excepto las oficiales (como ps_mainmenu, ps_searchbar, etc.) y ve activándolos de uno en uno.

[TIP] Si el error apareció justo después de instalar un módulo, empieza por desactivar ese mismo.

2. Tema o plantilla incompatible

Un tema mal diseñado o que no está actualizado puede generar un error 500, sobre todo si has actualizado PrestaShop recientemente.

Solución:

1. Cambia temporalmente al tema predeterminado (por ejemplo, "Classic" en PrestaShop 1.7 o "default-bootstrap" en versiones anteriores).
2. Para hacerlo sin acceso al panel, ve a la carpeta /themes y renombra la carpeta de tu tema actual (por ejemplo, mitema → mitema_). Luego, renombra la carpeta del tema por defecto a mitema (el nombre que espera tu configuración). O mejor aún, edita el archivo config/settings.inc.php (o app/config/parameters.php en versiones 1.7+) y cambia el valor de _THEME_NAME_ al nombre del tema por defecto.
3. Recarga la web. Si funciona, el problema está en tu tema. Contacta con el desarrollador o busca una actualización.

3. Límite de memoria PHP excedido

Si ves un mensaje como "Allowed memory size of 134217728 bytes exhausted", tu tienda necesita más memoria de la que el servidor le permite.

Solución:

1. Aumenta el límite de memoria editando el archivo php.ini (si tienes acceso) o el archivo .htaccess en la raíz de tu web.
2. En .htaccess añade esta línea:

   php_value memory_limit 256M
   

   O incluso 512M si tu hosting lo permite.
3. Si usas Syspanel (puerto 2106), puedes hacerlo desde la sección "PHP Settings" o "Configuración de PHP".
4. Guarda los cambios y recarga.

[INFO] Si no tienes acceso a .htaccess, pide a tu proveedor de hosting que aumente el límite de memoria. Es un cambio muy común y rápido.

4. Errores de sintaxis en archivos (después de actualizar)

A veces, al actualizar PrestaShop o un módulo, algún archivo se corrompe o tiene errores de sintaxis.

Solución:

1. Revisa el mensaje de error del modo debug. Te dirá la línea exacta del archivo donde está el fallo.
2. Reemplaza ese archivo con una copia original de la misma versión de PrestaShop. Puedes descargar la versión desde el sitio oficial de PrestaShop y extraer solo ese archivo.
3. Si el error está en un módulo, desinstálalo y vuelve a instalarlo desde cero.
4. Si el error es en el núcleo de PrestaShop, considera hacer una reinstalación limpia de los archivos del sistema (sin borrar la base de datos). Esto se hace sobrescribiendo todos los archivos excepto /config/settings.inc.php y la carpeta /img.

5. Permisos de archivos incorrectos

Los archivos de PrestaShop deben tener permisos específicos para que el servidor pueda leerlos y escribir en ellos.

Solución:

1. Establece permisos correctos:
   • Carpetas: 755 (o 775 en algunos servidores).
   • Archivos: 644 (o 664).
2. Puedes hacerlo desde tu cliente FTP: selecciona todos los archivos y carpetas, haz clic derecho y elige "Permisos de archivo". Marca las opciones adecuadas (Lectura y Escritura para el propietario, solo Lectura para el grupo y otros).
3. Aplica recursivamente a todas las subcarpetas.
4. También puedes usar un comando SSH si tienes acceso:

   find . -type d -exec chmod 755 {} \;
   find . -type f -exec chmod 644 {} \;
   

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

6. Problemas con el archivo .htaccess

Un .htaccess corrupto o mal configurado puede generar un error 500.

Solución:

1. Renombra el archivo .htaccess a .htaccess_old (desde FTP).
2. Recarga tu tienda. Si funciona, regenera el .htaccess desde el panel de administración de PrestaShop: ve a "Parámetros de la tienda" → "Tráfico y SEO" → "URLs amigables" y haz clic en "Guardar" (aunque no cambies nada). Esto lo regenerará automáticamente.
3. Si no puedes acceder al panel, crea un archivo .htaccess nuevo con el contenido básico de PrestaShop (puedes copiarlo de una instalación limpia).

¿Sigues con el error? Prueba estas soluciones avanzadas

7. Verificar la versión de PHP

PrestaShop requiere una versión específica de PHP. Por ejemplo, PrestaShop 1.7 necesita PHP 7.1 o superior (recomendado 7.4 o 8.0). Si tu servidor tiene PHP 5.6, es probable que obtengas errores.

Solución:

1. Cambia la versión de PHP desde tu panel de hosting (Syspanel, cPanel, etc.). En Syspanel, ve a "PHP Settings" y elige la versión recomendada.
2. Si no puedes cambiarlo, contacta con tu proveedor.

8. Revisar los logs del servidor

Los logs del servidor suelen contener información más detallada sobre el error 500.

Solución:

1. Busca la carpeta /logs en la raíz de tu servidor (o en /var/log/ si tienes acceso SSH).
2. Abre el archivo error.log (o similar) y busca la línea que coincida con la hora del error.
3. Te dará pistas como "PHP Fatal error: Uncaught Error: Class 'X' not found" que te indicarán exactamente qué clase o archivo falta.

9. Restaurar una copia de seguridad

Si nada funciona, la solución más drástica pero efectiva es restaurar una copia de seguridad de tu tienda (archivos y base de datos) de antes de que apareciera el error.

[TIP] Siempre haz una copia de seguridad antes de instalar módulos o actualizar. Te ahorrará muchos dolores de cabeza.

Preguntas frecuentes (FAQ)

¿Por qué aparece el error 500 solo en algunas páginas?

Si el error 500 solo aparece en páginas específicas (por ejemplo, en la página de inicio pero no en las de producto), es probable que el problema esté en un módulo que se carga solo en esa página (como un slider o un bloque de categorías). Revisa los módulos relacionados con esa sección.

¿El error 500 puede deberse a un ataque hacker?

Sí, aunque es menos común. Un hacker puede modificar archivos de PrestaShop para inyectar código malicioso, lo que a veces provoca errores 500. Si sospechas de un ataque, revisa los archivos recién modificados (puedes usar la herramienta "Comprobar integridad de los archivos" en el panel de administración de PrestaShop, si tienes acceso).

¿Puedo evitar el error 500 en el futuro?

Sí, siguiendo estas buenas prácticas:

• Actualiza siempre PrestaShop y los módulos a la última versión estable.
• Haz copias de seguridad antes de cualquier cambio importante.
• Usa un tema y módulos de fuentes confiables (oficiales o de desarrolladores reconocidos).
• No instales módulos innecesarios; cuantos menos, menos conflictos.
• Mantén un límite de memoria PHP adecuado (al menos 128MB, recomendado 256MB).

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

Si el error 500 te impide entrar al back office, usa las soluciones manuales por FTP que te he explicado (desactivar módulos renombrando carpetas, cambiar el tema, etc.). También puedes intentar acceder a tu web desde otro navegador o en modo incógnito.

¿El error 500 afecta a mi SEO?

Sí, temporalmente. Si el error persiste, los motores de búsqueda pueden penalizar tu tienda porque no pueden acceder a ella. Soluciona el error lo antes posible y, una vez restaurada, verifica en Google Search Console que no haya problemas de rastreo.

Conclusión

El error 500 PrestaShop puede parecer aterrador, pero como has visto, en la mayoría de los casos se soluciona con unos pocos pasos: activar el modo debug, identificar el módulo o tema problemático, y desactivarlo o reemplazarlo. Recuerda siempre tener una copia de seguridad y no entrar en pánico. Si sigues esta guía PrestaShop errores, podrás resolverlo tú mismo sin necesidad de un técnico.

Si después de todo esto el error persiste, contacta con tu proveedor de hosting (menciona que has seguido esta guía) o con un desarrollador especializado en PrestaShop. Pero te aseguro que con un poco de paciencia, lo solucionarás. ¡Ánimo y a seguir vendiendo!