Error 500 en PrestaShop: causas y soluciones definitivas

¡Hola! Si estás leyendo esto, es muy probable que tu tienda online te haya dado un buen susto: la temida pantalla blanca o el mensaje "Error 500 Internal Server Error" en tu PrestaShop. No te preocupes, respira hondo.

Este error es el más común en el mundo del hosting y casi siempre es un problema de configuración, permisos o un módulo conflictivo, no el fin del mundo. En esta guía de diagnóstico completa, vamos a quitarte el miedo y te voy a enseñar, paso a paso y con un lenguaje muy sencillo, cómo solucionar el error 500 en PrestaShop.

Vamos a ir de lo más simple a lo más complejo, como un auténtico detective digital. Coge un café, ten a mano los accesos a tu hosting y al panel de administración de tu tienda, y vamos a ello.

¿Qué significa realmente el Error 500 en PrestaShop?

Antes de ponernos el mono de trabajo, es importante que entiendas qué está pasando. Un error 500 es un mensaje genérico del servidor que dice: "Algo ha ido muy mal, pero no te voy a decir exactamente qué".

En el contexto de PrestaShop, este error suele aparecer por tres motivos principales:

Un archivo .htaccess corrupto o con reglas incorrectas.
Permisos de archivos y carpetas mal configurados (demasiado permisivos o demasiado restrictivos).
Un módulo o override (sobrescritura) que provoca un fallo fatal de PHP.

A veces, también puede ser un problema de memoria (límite de memoria PHP agotado) o un fallo del propio servidor. Pero vamos a centrarnos en las causas más probables y en cómo solucionarlas.

Fase 1: Preparación y Primeros Auxilios (Lo más rápido)

Esta es la fase de "triaje". Vamos a intentar las soluciones más rápidas y que no requieren conocimientos técnicos profundos.

1.1 Activa el Modo Debug (Depuración) de PrestaShop

PrestaShop tiene un modo oculto que, en lugar de mostrarte el error 500 genérico, te muestra el error real y específico. Es como pasar de una radiografía borrosa a una resonancia magnética.

Para activarlo, necesitas acceder a tus archivos a través del Administrador de Archivos de tu hosting o mediante un cliente FTP (como FileZilla).

Busca la carpeta raíz donde está instalada tu tienda (normalmente public_html, www o htdocs).
Dentro, busca el archivo llamado config/defines.inc.php.
Descarga este archivo a tu ordenador y ábrelo con un editor de texto simple (como el Bloc de Notas).
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 a la misma ubicación, sobrescribiendo el original.

[TIP] Ahora, al recargar tu tienda, verás un mensaje de error mucho más detallado, con la ruta del archivo problemático y la línea exacta. Anota ese mensaje, es oro puro para el diagnóstico. Cuando termines, vuelve a poner false para que los clientes no vean información sensible.

1.2 La Regla de Oro: Regenerar el `.htaccess`

El archivo .htaccess es un archivo de configuración mágico en servidores Apache. PrestaShop lo genera automáticamente, pero a veces se corrompe al instalar un módulo o al cambiar la URL de la tienda.

Para regenerarlo desde el panel de administración (si es que puedes acceder a él):

Ve a Parámetros Avanzados > Rendimiento.
Busca la sección "Herramientas de generación de archivos" o similar.
Activa la opción "Forzar la compilación" si existe.
Haz clic en el botón "Guardar" o "Generar archivo .htaccess".

Si no puedes acceder al panel de administración, tendrás que hacerlo manualmente:

Ve a tu gestor de archivos o FTP.
Busca el archivo .htaccess en la raíz. Ojo: Los archivos que empiezan por un punto están ocultos. Asegúrate de activar la opción "Mostrar archivos ocultos" en tu gestor o cliente FTP.
Descarga una copia de seguridad a tu ordenador (por si acaso).
Elimina el archivo .htaccess del servidor.
Ve a tu tienda en el navegador. PrestaShop debería regenerar un archivo nuevo automáticamente.

[WARNING] Si al eliminar el archivo tu tienda sigue dando error 500, no te preocupes. Puede que el problema sea otro. Vamos a seguir investigando.

Fase 2: Diagnóstico Profundo (Cuando el problema persiste)

Si los primeros auxilios no han funcionado, es hora de ponerse el traje de ingeniero. Vamos a revisar los permisos y los módulos.

2.1 La Pesadilla de los Permisos

Los archivos y carpetas de tu servidor tienen "permisos" que indican quién puede leer, escribir o ejecutar. Si estos permisos son incorrectos, PrestaShop no puede funcionar.

Carpetas (Directorios): Deben tener permiso 755.
Archivos: Deben tener permiso 644.

Para cambiarlos:

Selecciona todos los archivos y carpetas de la raíz de tu instalación.
Usa la opción "Cambiar permisos" o "Chmod" de tu gestor de archivos o FTP.
Aplica 755 a todas las carpetas y 644 a todos los archivos.

[INFO] Si has hecho esto y el error persiste, es posible que tu servidor requiera permisos diferentes (por ejemplo, 775 y 664). Consulta con tu proveedor de hosting para asegurarte. A veces, la solución es simplemente dar permisos 755 a la carpeta var/cache y sus subcarpetas, ya que es donde PrestaShop guarda los archivos temporales.

2.2 El Sospechoso Habitual: Módulos y Overrides

Esta es la causa número uno de errores 500 después de una actualización. Un módulo desactualizado o un "override" (una personalización de un archivo core) puede romper toda la tienda.

Cómo diagnosticar si es un módulo:

Renombra la carpeta de módulos. Ve a tu FTP y busca la carpeta modules. No la borres, solo renómbrala a modules_backup (o algo similar).
Crea una carpeta nueva y vacía llamada modules.
Ahora intenta acceder a tu tienda.

Si la tienda funciona: ¡Bingo! El problema es un módulo. Lo que tienes que hacer es ir moviendo módulos de modules_backup a la carpeta modules nueva, uno por uno, y comprobar la tienda después de cada movimiento. Cuando la tienda se rompa, habrás encontrado al culpable.
Si la tienda sigue rota: No es un módulo. Crea una carpeta modules de nuevo y renombra la carpeta modules_backup a modules para restaurar todo.

[WARNING] Este método es un poco brusco y puede tardar, pero es 100% efectivo. Hazlo con calma.

Cómo diagnosticar si es un override:

Los overrides se guardan en la carpeta override/classes y override/controllers.

Ve a tu carpeta override.
Renombra la carpeta classes a classes_backup y la carpeta controllers a controllers_backup.
Crea carpetas nuevas vacías llamadas classes y controllers.
Prueba tu tienda.

Si funciona, el problema es un override. Deberás revisar los archivos que has movido y decidir cuál es el que da problemas (normalmente los que han sido modificados para una función específica).

Fase 3: Ajustes Avanzados del Servidor

Si hemos llegado hasta aquí y nada funciona, el problema puede estar en la configuración de PHP de tu servidor.

3.1 Aumentar el Límite de Memoria PHP

PrestaShop es un "glotón" de recursos. Si tu tienda tiene muchos productos o módulos, puede agotar la memoria PHP asignada.

Accede a tu panel de control de hosting (cPanel, Plesk, o Syspanel).
Busca la sección "Gestión de PHP", "Configuración de PHP" o "Selector de Versión de PHP".
Dentro, busca el parámetro memory_limit.
Cámbialo a 256M o incluso 512M si tu hosting lo permite.
Guarda los cambios y reinicia PHP si es necesario.

[TIP] En Syspanel (recuerda que el puerto de acceso es el 2106), esta opción suele estar en "Servicios Web" o "Configuración de PHP". Es muy visual y fácil de encontrar.

3.2 Cambiar la Versión de PHP

A veces, un módulo o el propio PrestaShop no es compatible con la versión de PHP de tu servidor. Por ejemplo, si tienes PrestaShop 1.6 y PHP 8.0, es casi seguro que tendrás errores.

Ve a la misma sección de configuración de PHP de tu hosting.
Busca la opción para cambiar la versión de PHP.
Si PrestaShop es 1.7.x, te recomiendo PHP 7.1 a 7.4. Si es 1.6.x, PHP 5.6 o 7.0 es lo más seguro.
Prueba tu tienda después de cada cambio.

Fase 4: La Solución Definitiva (Borrar la Caché)

PrestaShop guarda archivos de caché para cargar más rápido. A veces, estos archivos se corrompen y causan el error 500. Este es un paso que deberías haber probado antes, pero lo dejo para el final porque es muy efectivo.

Ve a la carpeta var/cache (en PrestaShop 1.7) o cache (en PrestaShop 1.6).
Borra todo el contenido de esa carpeta. No borres la carpeta en sí, solo lo que hay dentro.
También puedes intentar borrar el contenido de la carpeta cache/smarty/compile y cache/smarty/cache.

[INFO] Algunos paneles de control como Syspanel ofrecen un botón de "Limpiar caché" directamente en el panel de administración de PrestaShop. Si tienes acceso, úsalo. Si no, hacerlo manualmente vía FTP es igual de válido.

Preguntas Frecuentes (FAQ)

Para terminar, vamos a resolver las dudas más comunes que surgen con este error.

¿Puedo perder mis datos si borro el `.htaccess` o la caché?

No. Esos archivos no contienen datos de tus productos, clientes o pedidos. Son archivos de configuración y temporales. PrestaShop los regenera automáticamente.

He seguido todos los pasos y el error 500 PrestaShop persiste. ¿Qué hago?

Si has llegado hasta aquí y nada funciona, el problema puede estar en el servidor en sí. Contacta con tu proveedor de hosting. Diles que has hecho un diagnóstico básico y que el problema parece estar en la configuración del servidor o en un error de PHP no relacionado con tu script. A veces, hay un error en el registro del servidor (error_log) que solo ellos pueden ver.

¿Por qué me piden que use el puerto 2106 para Syspanel?

Syspanel es el nombre de nuestro panel de control personalizado. Para garantizar una capa extra de seguridad, el acceso a la gestión avanzada y a los archivos de configuración se realiza a través de un puerto no estándar, el 2106. Es una medida de seguridad para que los "hackers" no puedan atacar la interfaz de gestión desde el puerto por defecto (2083). Es totalmente normal y seguro.

¿Arreglar mi tienda online es muy caro?

Depende. Si sigues esta guía, la mayoría de las veces lo solucionarás tú mismo sin coste alguno. Si el problema es muy complejo y no te ves capaz, siempre puedes contratar a un desarrollador especializado en PrestaShop. Pero te aseguro que el 90% de los casos se resuelven con los pasos de este artículo.

Conclusión: No le temas al Error 500

El error 500 PrestaShop es un dolor de cabeza, pero como has visto, tiene solución. La clave está en el diagnóstico metódico: empieza por lo fácil (regenerar .htaccess y limpiar caché), pasa a lo intermedio (permisos y módulos) y termina con lo avanzado (configuración PHP).

Espero que esta guía te haya sido de gran ayuda. Recuerda que la paciencia es tu mejor aliada. Ve paso a paso, sin prisas, y sobre todo, haz siempre una copia de seguridad antes de modificar cualquier archivo. ¡Tu tienda online volverá a estar en pie en poco tiempo!