Solucionar error 500 en PrestaShop - Guía de troubleshooting

Primeros pasos: qué significa realmente el error 500

El error 500 es, probablemente, el mensaje más frustrante que puedes ver en tu tienda PrestaShop. Es tan genérico que no te dice nada concreto: "Error interno del servidor". Pero no te preocupes, porque en la mayoría de los casos tiene solución y, a menudo, puedes arreglarlo tú mismo sin necesidad de contratar a un especialista.

Antes de lanzarte a probar soluciones al azar, es fundamental que entiendas una cosa: el error 500 en PrestaShop casi nunca aparece por una sola razón. Puede ser un archivo con permisos incorrectos, un módulo incompatible, un problema de memoria o incluso un error en el archivo .htaccess. Por eso, lo mejor es ir descartando causas poco a poco, de la forma más ordenada posible.

En esta guía te voy a explicar, paso a paso y con un lenguaje muy sencillo, cómo solucionar el error 500 en PrestaShop. Vamos a empezar por lo más básico y luego iremos subiendo la dificultad. No necesitas ser un experto en Linux ni en SysAdmin para seguir estos consejos, aunque al final también te daré algunas claves para los que tenéis más soltura con el servidor.

Activa el modo debug de PrestaShop para ver el error real

El primer consejo, y el más importante de todos, es que dejes de pelear contra un mensaje genérico. PrestaShop tiene un modo de depuración (debug) que te muestra el error real que está ocurriendo. Con esa información, solucionar el error 500 será mucho más fácil.

Para activar el modo debug, tienes que acceder al archivo config/defines.inc.php de tu instalación de PrestaShop. Puedes hacerlo desde el administrador de archivos de tu hosting o mediante FTP con un programa como FileZilla.

Busca la línea que dice define('_PS_MODE_DEV_', false); y cámbiala por define('_PS_MODE_DEV_', true);. Guarda el archivo y vuelve a cargar tu tienda. Ahora, en lugar del error 500, verás un mensaje en pantalla con la descripción del problema, la ruta del archivo que lo causa y la línea exacta donde se produce.

[INFO] Una vez que hayas solucionado el problema, recuerda volver a poner _PS_MODE_DEV_ en false. Dejar el modo debug activado en producción es un riesgo de seguridad y además muestra información sensible a tus clientes.

Si no puedes acceder al archivo por FTP, también puedes activar el modo debug desde el panel de administración de PrestaShop, en Parámetros avanzados > Rendimiento, pero si el error te impide entrar al back-office, tendrás que hacerlo manualmente.

Revisa el log de PrestaShop y los logs del servidor

Cuando el modo debug no te da suficiente información, o si prefieres hacer las cosas de forma más "limpia", el siguiente paso es consultar los logs. Aquí tienes dos fuentes de información muy valiosas.

El log de PrestaShop

PrestaShop guarda un registro de errores en la carpeta var/logs/ (en versiones modernas) o en log/ (en versiones antiguas). Busca un archivo con un nombre parecido a es.log o prod.log. Ábrelo con un editor de texto y busca las últimas líneas. Ahí verás el error exacto que está provocando el problema.

Los logs del servidor

Si el log de PrestaShop no te dice nada, tendrás que mirar los logs del servidor. Si tu hosting usa un panel tipo cPanel o Syspanel (recuerda que el puerto de acceso a Syspanel es el 2106), puedes encontrar los logs en la sección de "Registros de errores" o "Error Logs". Busca el archivo error.log de tu dominio o el error_log en la raíz de tu cuenta.

[TIP] Los logs del servidor suelen ser la fuente de información más fiable. Si ves errores del tipo "PHP Fatal error: Allowed memory size exhausted", ya sabes que el problema es de memoria. Si ves "Permission denied", es un problema de permisos.

Soluciones rápidas para el error 500 en PrestaShop

Si no tienes tiempo para investigar a fondo, o si los logs no te dan una pista clara, prueba estas soluciones rápidas que resuelven la mayoría de los casos.

1. Regenera el archivo .htaccess

El archivo .htaccess es un archivo de configuración que controla cómo funciona tu tienda a nivel de servidor. A veces se corrompe o se queda con reglas obsoletas, lo que provoca el error 500 en PrestaShop.

Para regenerarlo, entra en el back-office de PrestaShop (si puedes) y ve a Parámetros avanzados > Rendimiento. Busca la sección "Archivo .htaccess" y haz clic en "Guardar" o "Regenerar". Si no puedes acceder al back-office, tendrás que hacerlo manualmente: renombra el archivo .htaccess a .htaccess_old (por ejemplo) y recarga tu tienda. PrestaShop generará uno nuevo automáticamente.

[WARNING] Si renombras el .htaccess y tu tienda funciona, genial. Pero ten en cuenta que perderás las reglas de redirección personalizadas que hubieras configurado. Asegúrate de tener una copia de seguridad antes de tocarlo.

2. Comprueba los permisos de archivos y carpetas

Los permisos incorrectos son una de las causas más comunes del error 500 en PrestaShop. Los archivos deben tener permiso 644 y las carpetas 755. No deberías tener nada con permisos 777 (aunque a veces es necesario para ciertas carpetas de caché).

Puedes cambiar los permisos desde el administrador de archivos de tu hosting o con un cliente FTP. Si usas Syspanel, recuerda que el puerto de acceso es el 2106 y desde ahí puedes gestionar los archivos de tu cuenta de hosting.

3. Vacía la caché de PrestaShop

A veces, la caché de PrestaShop se corrompe y provoca errores extraños. Para vaciarla, borra el contenido de las carpetas var/cache/ (en PrestaShop 1.7 y 1.8) o cache/ (en versiones anteriores). No borres las carpetas en sí, solo su contenido.

Si no puedes acceder por FTP, también puedes intentar vaciar la caché desde el back-office en Parámetros avanzados > Rendimiento, aunque si el error te bloquea el acceso, tendrás que hacerlo manualmente.

Problemas de memoria: ajusta el límite de PHP

Uno de los errores más comunes detrás de un error 500 en PrestaShop es que PHP se queda sin memoria. Esto es especialmente frecuente en tiendas con muchos módulos o con catálogos grandes.

Para solucionarlo, tienes que aumentar el límite de memoria de PHP. Puedes hacerlo de varias formas:

Desde el archivo php.ini: busca la línea memory_limit y cámbiala a memory_limit = 256M o incluso 512M.
Desde el archivo .htaccess: añade esta línea al final: php_value memory_limit 256M.
Desde Syspanel: si tu hosting usa este panel, recuerda que el puerto de acceso es el 2106. Ahí puedes buscar la sección de "PHP" o "Configuración de PHP" y ajustar el límite de memoria desde una interfaz gráfica.

[INFO] Si no encuentras el archivo php.ini, crea uno nuevo en la raíz de tu instalación de PrestaShop con el contenido: memory_limit = 256M. También puedes añadir max_execution_time = 300 para evitar errores de tiempo de ejecución.

El módulo o tema que causa el error 500 en PrestaShop

Si has llegado hasta aquí y el problema sigue, es muy probable que la causa sea un módulo o un tema incompatible. Esto es especialmente habitual después de actualizar PrestaShop o de instalar una nueva extensión.

Cómo identificar al culpable

La forma más rápida de saber si un módulo es el problema es desactivarlo. Pero si no puedes acceder al back-office, tendrás que hacerlo desde la base de datos.

Accede a la base de datos de tu tienda (con phpMyAdmin o desde Syspanel, puerto 2106) y busca la tabla ps_module. Ahí verás una lista de todos los módulos instalados. Cambia el valor del campo active de 1 a 0 en los módulos que sospeches que pueden ser el problema. Empieza por los más recientes o los que hayas instalado justo antes de que apareciera el error.

Prueba con un tema por defecto

Si el problema no son los módulos, puede ser el tema. Cambia temporalmente a un tema por defecto de PrestaShop (como Classic). Puedes hacerlo desde la base de datos, en la tabla ps_shop_url o directamente editando el archivo config/settings.inc.php (en versiones antiguas) buscando la línea que define el tema.

Otras causas menos comunes pero importantes

1. El archivo `settings.inc.php` está corrupto

Este archivo, que se encuentra en config/, contiene la configuración de conexión a la base de datos. Si está dañado, PrestaShop no puede arrancar. Puedes restaurarlo desde una copia de seguridad o volver a generarlo si sabes los datos de tu base de datos.

2. Actualizaciones incompletas

Si el error 500 apareció después de una actualización, es posible que la actualización no se completó correctamente. Revisa si hay archivos incompletos o si la versión de PHP de tu servidor es compatible con la versión de PrestaShop que tienes instalada.

3. Problemas con el certificado SSL

Si has instalado recientemente un certificado SSL o has cambiado la configuración de HTTPS, puede haber un conflicto. Revisa la configuración en config/settings.inc.php o en el back-office para asegurarte de que la URL de tu tienda es correcta.

Consejos de prevención para no volver a sufrir el error 500

Una vez que hayas solucionado el error 500 en PrestaShop, lo mejor es tomar medidas para que no vuelva a aparecer. Aquí tienes algunas buenas prácticas:

Haz copias de seguridad periódicas: tanto de los archivos como de la base de datos. Así, si algo falla, puedes restaurar la tienda en minutos.
Actualiza PrestaShop con cuidado: antes de actualizar, lee las notas de la versión y comprueba que tus módulos y tema son compatibles.
No instales módulos de fuentes dudosas: un módulo mal programado puede romper tu tienda entera. Usa siempre el marketplace oficial de PrestaShop o desarrolladores de confianza.
Mantén un entorno de pruebas: si tienes experiencia técnica, monta una copia de tu tienda en un subdominio o en local para probar cambios antes de aplicarlos en producción.
Monitoriza los logs: revisa los logs de tu servidor de vez en cuando. Detectar un error a tiempo puede evitar que se convierta en un problema grave.

Preguntas frecuentes sobre el error 500 en PrestaShop

¿El error 500 puede deberse a un problema de hosting?

Sí, es posible. Si tu servidor está sobrecargado, tiene poca memoria o la configuración de PHP es muy restrictiva, puede provocar errores 500. Si has probado todas las soluciones anteriores y el error persiste, contacta con tu proveedor de hosting.

¿Cómo puedo saber si el error es de PHP o de la base de datos?

Si el error viene de PHP, verás mensajes como "Fatal error" o "Allowed memory size". Si es de la base de datos, verás errores de conexión o de consultas SQL. Los logs te darán la respuesta exacta.

¿Puedo solucionar el error 500 sin acceso al back-office?

Sí, la mayoría de las soluciones que te he explicado se pueden hacer por FTP o desde el administrador de archivos de tu hosting. El modo debug, la regeneración del .htaccess, los permisos y la limpieza de caché no requieren acceso al back-office.

¿Cuánto tiempo se tarda en arreglar este error?

Depende de la causa. Si es un problema de permisos o de caché, puedes solucionarlo en 10 minutos. Si es un módulo incompatible, puede llevarte un par de horas. Si es un problema del servidor, tendrás que esperar a que tu hosting lo resuelva.

Resumen final: plan de acción contra el error 500

Para terminar, te dejo un plan de acción resumido para que vayas por orden:

Activa el modo debug de PrestaShop para ver el error real.
Revisa los logs de PrestaShop y del servidor.
Regenera el .htaccess y comprueba los permisos de archivos.
Vacía la caché de PrestaShop.
Aumenta el límite de memoria de PHP.
Desactiva módulos sospechosos o cambia de tema.
Si nada funciona, contacta con tu hosting o con un profesional.

Recuerda que el error 500 en PrestaShop es un problema común y con solución. No te desesperes y ve paso a paso. Con estas herramientas y un poco de paciencia, tu tienda volverá a funcionar en poco tiempo. Y si tienes dudas, busca ayuda especializada: a veces, un par de ojos expertos (y un buen log) lo resuelven todo mucho más rápido.