Error 500 en PrestaShop | Solución definitiva

¡Hola! Si estás leyendo esto, probablemente te has encontrado con la temida pantalla blanca o el mensaje de error 500 PrestaShop en tu tienda. No te preocupes, es uno de los problemas más comunes en el mundo del ecommerce y, en la gran mayoría de los casos, tiene solución sin necesidad de ser un experto en programación.

En esta guía extensa y paso a paso, vamos a desglosar qué significa exactamente este error, por qué ocurre y, lo más importante, cómo solucionar error 500 de forma segura y efectiva. Vamos a ir desde lo más simple (y menos invasivo) hasta lo más técnico, para que puedas recuperar tu tienda online cuanto antes.

¿Qué es exactamente el error 500 en PrestaShop?

Antes de ponernos manos a la obra, es crucial entender qué está pasando. El error 500 es un código de estado HTTP genérico que significa "Error Interno del Servidor". En términos sencillos: tu servidor (el ordenador donde vive tu tienda) entiende la petición, pero algo dentro de la aplicación (PrestaShop) o del propio servidor se ha roto o ha fallado, impidiendo que se genere la página.

A diferencia de un error 404 (página no encontrada) o un error 403 (acceso denegado), el error 500 no te dice qué falla. Es como si tu coche no arrancara y el mecánico solo te dijera "tiene un problema". Por eso, necesitamos hacer una pequeña investigación de diagnóstico.

[INFO]
La mayoría de las veces, este error aparece después de:

Instalar o actualizar un módulo o plantilla.

Cambiar la versión de PHP en el hosting.

Modificar archivos de configuración (como .htaccess o parameters.php).

Corrupción en la base de datos tras una copia o importación fallida.

Primeros pasos: Activa el modo debug de PrestaShop

PrestaShop tiene un "modo de depuración" (debug) que, cuando se activa, muestra el error real en pantalla en lugar de la página en blanco. Esto es oro puro para el diagnóstico.

Para activarlo, necesitas acceder a los archivos de tu hosting (normalmente mediante un administrador de archivos del panel de control o un cliente FTP como FileZilla). Busca la carpeta config en la raíz de tu instalación de PrestaShop. Dentro, encontrarás un archivo llamado defines.inc.php.

Descarga una copia de seguridad de ese archivo antes de tocarlo (por si acaso).
Ábrelo con un editor de texto plano (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 vuelta al servidor (reemplazando el original).

Ahora, recarga tu tienda. En lugar del error 500, verás una pantalla con un mensaje de error detallado, a menudo con un número de archivo y una línea específica. Anota ese mensaje, porque nos dará la pista principal para solucionarlo.

[WARNING]
No olvides volver a poner _PS_MODE_DEV_ en false una vez hayas arreglado el problema. Dejar el modo debug activo en una tienda en producción es un riesgo de seguridad grave, ya que expone rutas internas de tu servidor a los visitantes.

Solución 1: Limpiar la caché de Smarty y el caché del navegador

Esta es la solución más fácil y, sorprendentemente, la que resuelve muchos errores 500 en PrestaShop. A veces, la caché de plantillas (Smarty) se corrompe o guarda información antigua que entra en conflicto con los nuevos archivos.

Si no puedes acceder al panel de administración (Back Office), tendrás que hacerlo manualmente a través de tu hosting:

Accede a tu panel de control (cPanel, Syspanel, Plesk, etc.). Si usas Syspanel, recuerda que el acceso es a través del puerto 2106 (ej. https://tu-dominio.com:2106).
Ve al Administrador de Archivos o conéctate por FTP.
Localiza la carpeta raíz donde está instalado PrestaShop.
Busca la carpeta var/cache. Dentro, verás subcarpetas llamadas dev y prod (o solo cache en versiones antiguas).
Elimina TODOS los archivos que están dentro de var/cache/prod (o si no existe, dentro de cache). No borres la carpeta en sí, solo su contenido.
Vuelve a intentar cargar tu tienda.

Si el problema era de caché, tu tienda debería cargar de nuevo. Si no, continúa con el siguiente paso.

Solución 2: Revisar los permisos de archivos y carpetas

Los permisos incorrectos son otra causa muy frecuente de errores 500. Si un archivo o carpeta no tiene los permisos adecuados, el servidor no puede leerlo o escribirlo, y responde con un error interno.

Los permisos estándar y correctos para PrestaShop son:

Carpetas (Directorios): Permiso 755 (lectura, escritura y ejecución para el propietario; lectura y ejecución para el grupo y otros).
Archivos: Permiso 644 (lectura y escritura para el propietario; solo lectura para el grupo y otros).

Para cambiarlos:

Desde tu administrador de archivos o FTP, selecciona la raíz de tu instalación.
Busca la opción "Permisos" o "CHMOD" (en Syspanel, suele estar en el menú del archivo o carpeta).
Asegúrate de que la carpeta raíz y todas las subcarpetas tengan 755 y los archivos 644.
Si hay algún archivo que necesite escritura (como los de configuración), el permiso puede ser 664 o 666, pero esto es menos común.

[TIP]
La mayoría de los administradores de archivos tienen una opción para "aplicar permisos de forma recursiva" a todas las subcarpetas y archivos. Úsala para no tener que hacerlo uno por uno, pero ten en cuenta que esto puede tardar unos minutos.

Solución 3: El archivo .htaccess (muy común en error 500 PrestaShop)

El archivo .htaccess es un archivo de configuración que controla el comportamiento del servidor Apache. PrestaShop lo genera automáticamente, pero a veces se corrompe o es incompatible con la configuración de tu hosting.

Para descartar este problema:

Ve a la carpeta raíz de tu instalación.
Localiza el archivo .htaccess (puede estar oculto; asegúrate de activar "mostrar archivos ocultos" en tu administrador de archivos o FTP).
Descarga una copia de seguridad de este archivo en tu ordenador.
Renómbralo a algo como .htaccess.bak (esto lo desactiva).
Intenta cargar tu tienda.

Si la tienda carga, el problema era el .htaccess. Ahora, ve a tu Back Office (si puedes acceder) y ve a Parámetros Avanzados > Rendimiento. Ahí, busca el botón para "Regenerar el archivo .htaccess". Si no puedes acceder al Back Office, puedes intentar copiar un .htaccess limpio desde una instalación nueva de PrestaShop de la misma versión, o simplemente dejar el archivo desactivado y contactar con tu soporte de hosting para que lo regeneren.

Solución 4: Verificar la configuración de PHP

PrestaShop es exigente con la versión de PHP y los límites de memoria. Un cambio de versión de PHP o una configuración de memoria demasiado baja son causas directas de errores 500.

Accede a tu panel de control (Syspanel, cPanel, etc.).
Busca la sección "Gestor de PHP" o "Select PHP Version" (en Syspanel, suele estar en "Avanzado" o "PHP Configuration").
Asegúrate de que la versión de PHP es compatible con tu versión de PrestaShop. Por ejemplo, PrestaShop 1.7 funciona mejor con PHP 7.x, mientras que PrestaShop 8.x necesita PHP 7.2 o superior (recomendado PHP 8.0).
En la misma sección, busca los límites de recursos. Aumenta el memory_limit a 256M o 512M. También puedes aumentar max_execution_time a 120 o 300.

[WARNING]
Cambiar la versión de PHP puede hacer que otros módulos o tu tema dejen de funcionar si no son compatibles. Si el error 500 apareció justo después de un cambio de versión, revierte al anterior y busca alternativas.

Solución 5: Deshabilitar módulos o temas recientes

Si el error empezó tras instalar o actualizar un módulo, ese es el principal sospechoso. Dado que el error 500 impide acceder al Back Office, necesitamos desactivar el módulo manualmente.

Conecta por FTP o administrador de archivos.
Navega a la carpeta modules en la raíz de PrestaShop.
Busca la carpeta del módulo problemático (si sabes cuál es). Si no lo sabes, busca carpetas con fechas de modificación recientes.
Renombra la carpeta del módulo, por ejemplo, de mimodulo a mimodulo_OFF. Esto hará que PrestaShop no lo reconozca y lo desactive automáticamente.
Prueba a cargar tu tienda.

Si tu tienda vuelve a funcionar, has encontrado al culpable. Puedes intentar reinstalar el módulo (si es de pago, asegúrate de tener la última versión) o buscar una alternativa.

Si el problema no es un módulo, el problema puede ser tu tema (plantilla). El proceso es similar, pero con la carpeta themes. Cambia el nombre de tu tema activo y PrestaShop intentará usar el tema predeterminado. Si esto funciona, el problema es de tu plantilla.

Solución 6: Comprobar la base de datos

Una base de datos corrupta o con errores también puede lanzar un error 500. Esto es más común tras una migración o una restauración de copia de seguridad incompleta.

Accede a phpMyAdmin (o la herramienta de gestión de bases de datos de tu panel de control, como Syspanel).
Selecciona la base de datos de tu PrestaShop.
En la pestaña "Exportar", haz una copia de seguridad completa de la base de datos. Esto es crucial.
Una vez exportada, vuelve a la pestaña "SQL" o "Consultas".
Ejecuta la siguiente consulta SQL para reparar todas las tablas: REPAIR TABLE no funciona en todas las versiones, pero puedes usar CHECK TABLE primero. Una opción más sencilla es marcar todas las tablas (clic en "Seleccionar todo") y en el menú desplegable elegir "Reparar tabla".

Si la reparación no funciona, es posible que necesites restaurar una copia de seguridad anterior de la base de datos.

Solución 7: Revisar los logs del servidor (el último recurso)

Si has llegado hasta aquí y nada funciona, es hora de mirar los registros de errores del servidor. Estos son los archivos de "bitácora" donde se registran todos los fallos.

Busca una carpeta llamada logs o log en la raíz de tu hosting (a veces está fuera de la carpeta pública).
También puedes buscar un archivo llamado error_log dentro de la carpeta raíz de PrestaShop.
Descarga el archivo de logs más reciente y ábrelo.
Busca la última entrada con la fecha y hora en que ocurrió el error 500. El mensaje será técnico, pero te dará la ruta exacta del archivo problemático (por ejemplo, PHP Fatal error: Uncaught Error: Call to undefined function... in /home/user/public_html/vendor/...).

Con esa información, puedes buscar en Google la línea de error exacta o, si te sientes valiente, corregir el archivo (con cuidado). Si no entiendes el mensaje, este log es la mejor información que puedes proporcionar a tu soporte técnico de hosting o a un desarrollador.

[INFO]
Si tu hosting usa Syspanel, los logs de error suelen estar accesibles desde el menú "Logs" o "Registros" del panel. Recuerda que el acceso al panel es por el puerto 2106.

Preguntas Frecuentes (FAQ) sobre el error 500 en PrestaShop

¿El error 500 significa que he perdido mis datos?
No. El error 500 es un fallo de ejecución, no de almacenamiento. Tus productos, clientes y pedidos están a salvo en la base de datos. La solución del error no debería borrar datos, pero siempre es recomendable tener una copia de seguridad actualizada.

¿Cuánto tiempo se tarda en solucionar?
Depende de la causa. Limpiar la caché puede tardar 5 minutos. Un problema de módulo puede tardar 30 minutos. Un problema de base de datos puede llevar más tiempo y requerir ayuda profesional.

¿Puedo evitar que esto vuelva a pasar?
Sí, con buenas prácticas:

Haz copias de seguridad periódicas de archivos y base de datos.
Antes de instalar un módulo o actualizar, verifica que sea compatible con tu versión de PrestaShop y PHP.
No instales muchos módulos a la vez.
Mantén tu PrestaShop y sus módulos siempre actualizados.

¿Debo contactar con mi proveedor de hosting?
Si después de seguir todos los pasos de esta guía el error persiste, sí. El problema puede estar en la configuración del servidor (como una extensión de PHP deshabilitada) que solo ellos pueden ajustar. Dales toda la información que hayas recopilado, especialmente el mensaje de error del modo debug y los logs del servidor.

Esperamos que esta guía extensa te haya sido de gran ayuda para solucionar error 500 en tu tienda. Recuerda ir paso a paso, con calma y, sobre todo, haciendo copias de seguridad antes de cada cambio. ¡Tu tienda volverá a estar operativa en poco tiempo!