Solucionar error 500 en PrestaShop: Causas y soluciones | SysAdmin

¡Bienvenido, amigo usuario de PrestaShop! Si estás leyendo esto, probablemente te has topado con la temida pantalla en blanco o el mensaje "Error 500: Internal Server Error". No te preocupes, es uno de los problemas más comunes en entornos de hosting y, con la guía adecuada, podrás solucionarlo tú mismo. En este artículo, vamos a desglosar las causas más frecuentes de este error 500 en PrestaShop y te daremos soluciones paso a paso, pensadas tanto para principiantes como para SysAdmin que buscan un enfoque práctico.

Vamos a empezar con lo básico: un error 500 es un error genérico del servidor. Esto significa que algo falló en el lado del servidor (donde está alojada tu tienda) y no pudo procesar tu solicitud. No es un problema de tu ordenador ni de tu conexión a internet, así que respira hondo. Lo bueno es que, en la mayoría de los casos, tiene una solución clara y rápida.

¿Qué es exactamente un error 500 en PrestaShop?

El error 500 es como un "cajón de sastre" para los servidores web. Cuando ocurre, el servidor te dice: "Algo salió mal, pero no te voy a dar más detalles por seguridad". En PrestaShop, esto suele deberse a problemas con archivos del sistema, conflictos de módulos, errores de permisos o configuraciones incorrectas. Como SysAdmin o usuario avanzado, tu misión es investigar la causa raíz. Pero no temas, porque aquí te enseñaremos a hacerlo.

Causas comunes del error 500 en PrestaShop

Antes de lanzarnos a las soluciones, identifiquemos los sospechosos habituales. Estas son las causas más frecuentes que un SysAdmin encuentra al solucionar error 500 en PrestaShop:

1. Archivos PHP con errores de sintaxis o memoria insuficiente

PrestaShop está escrito en PHP. Si un archivo tiene un error de sintaxis (por ejemplo, una coma mal puesta) o el script consume más memoria de la permitida por el hosting, el servidor se bloquea y lanza el error 500.

2. Módulos o temas incompatibles o corruptos

Un módulo recién instalado o un tema personalizado puede tener código defectuoso. Esto es especialmente común después de actualizar PrestaShop o el propio módulo.

3. Problemas de permisos de archivos y carpetas

Los archivos de PrestaShop necesitan permisos específicos para que el servidor web pueda leerlos y escribirlos. Si están mal configurados (por ejemplo, permisos 777 en archivos que deberían ser 644), el servidor puede fallar.

4. Archivos .htaccess corruptos o mal configurados

El archivo .htaccess controla las reglas de reescritura de URL y otras configuraciones del servidor. Si se daña (por ejemplo, al desactivar la URL amigable), puede provocar un error 500.

5. Problemas con la configuración de PHP (límite de memoria, tiempo de ejecución)

Si tu tienda tiene mucho tráfico o muchos módulos, puede necesitar más memoria PHP de la que tiene asignada. También un tiempo de ejecución demasiado bajo puede causar errores.

6. Error en la base de datos

Aunque menos común, una tabla corrupta o un registro inválido en la base de datos puede generar un error 500 al intentar cargar una página.

7. Conflictos con el panel de control del hosting (como Syspanel)

A veces, el problema no está en PrestaShop, sino en la configuración del servidor. Por ejemplo, si usas Syspanel (el antiguo HestiaCP), recuerda que el acceso a su panel es por el puerto 2106. Un error en la configuración de PHP desde allí puede afectar a tu tienda.

Cómo solucionar el error 500 en PrestaShop: Paso a paso

Ahora vamos a la acción. Sigue estos pasos en orden, de lo más simple a lo más complejo. No te saltes ninguno, porque a menudo la solución más sencilla es la correcta.

Paso 1: Activar el modo debug de PrestaShop (¡el primer paso!)

Cuando ves un error 500, PrestaShop no te da detalles. Pero podemos forzarlo a que muestre el error real. Esto es clave para cualquier SysAdmin.

Accede a tu servidor vía FTP o al administrador de archivos de tu hosting.
Busca el archivo config/defines.inc.php en la raíz de tu instalación de PrestaShop.
Ábrelo con un editor de texto (como Notepad++ o el editor del panel).
Busca la línea: define('_PS_MODE_DEV_', false);
Cámbiala a: define('_PS_MODE_DEV_', true);
Guarda el archivo y sube los cambios si usas FTP.

Ahora, al recargar la página que daba error, verás un mensaje de error detallado (por ejemplo, "Fatal error: Allowed memory size of..."). Anota ese mensaje, porque te guiará directamente a la causa. Si no ves nada, es que el error es antes de que PHP se ejecute (por ejemplo, un problema de .htaccess).

[INFO] Después de solucionar el error, no olvides volver a poner _PS_MODE_DEV_ en false. Dejarlo activo en producción expone información sensible.

Paso 2: Revisar los logs del servidor (logs de error)

Si el modo debug no te da pistas (o no puedes acceder a FTP), revisa los logs del servidor. Cada hosting tiene su ubicación, pero lo común es:

cPanel: Logs de errores en "Métricas" > "Errores".
Syspanel: Ve a "Web" > "Logs" o busca en la carpeta /var/log/ de tu servidor. Recuerda que el acceso a Syspanel es por el puerto 2106.
Servidores dedicados/VPS: Busca en /var/log/apache2/error.log o /var/log/nginx/error.log.

Los logs te mostrarán líneas como [error] [client ...] ... que describen el error exacto. Por ejemplo, "PHP Fatal error: Allowed memory size of 134217728 bytes exhausted".

Paso 3: Aumentar el límite de memoria PHP

Este es uno de los problemas más comunes. Si el error dice algo de "memory size", haz esto:

Busca el archivo php.ini de tu servidor. Si no sabes dónde está, puedes crearlo en la raíz de PrestaShop (a veces llamado php.ini o .user.ini).
Añade o modifica esta línea: memory_limit = 256M (o incluso 512M si tu hosting lo permite).
Guarda y recarga la página.

Si no puedes modificar php.ini, prueba a añadir esto en un archivo .htaccess en la raíz:

php_value memory_limit 256M

[WARNING] No pongas un límite excesivo (ej. 2GB) si tu hosting no lo soporta. Consulta con tu proveedor.

Paso 4: Desactivar módulos o temas sospechosos

Si el error apareció después de instalar un módulo o cambiar el tema, es probable que sea el culpable. Para desactivarlos sin entrar al backoffice (que quizás tampoco carga):

Con FTP, ve a la carpeta modules/ de tu PrestaShop.
Renombra la carpeta del módulo sospechoso (por ejemplo, de micromodulo a micromodulo_desactivado). Esto lo desactiva automáticamente.
Para temas: ve a themes/ y renombra la carpeta del tema activo a otra cosa. PrestaShop usará el tema por defecto (si está disponible).

Si el error desaparece, ya sabes qué lo causaba. Puedes reinstalar el módulo/tema desde el backoffice más tarde.

Paso 5: Regenerar el archivo .htaccess

Un .htaccess corrupto es otra causa común. Para regenerarlo:

Con FTP, renombra el archivo .htaccess de la raíz a .htaccess_old (por si acaso).
Entra al backoffice de PrestaShop (si puedes) y ve a "Configuración" > "SEO y URLs".
Sin cambiar nada, haz clic en "Guardar". Esto regenera el archivo.
Si no puedes entrar al backoffice, crea un archivo .htaccess vacío y sube uno desde una instalación limpia de PrestaShop (de la misma versión).

[TIP] También puedes forzar la regeneración desde la base de datos, pero es más técnico. Mejor prueba esto primero.

Paso 6: Verificar permisos de archivos y carpetas

Los permisos incorrectos son un clásico. Los estándares para PrestaShop son:

Archivos: 644 (lectura/escritura para el usuario, solo lectura para el grupo y otros).
Carpetas: 755 (lectura/ejecución para todos, escritura solo para el usuario).

Puedes cambiarlos desde tu panel de control o FTP. En Syspanel, ve a "Archivos" > "Administrador de archivos" y selecciona "Permisos". Si usas línea de comandos (como SysAdmin), ejecuta:

find /ruta/a/prestashop -type f -exec chmod 644 {} \;
find /ruta/a/prestashop -type d -exec chmod 755 {} \;

[WARNING] Nunca pongas permisos 777 a todos los archivos. Es un riesgo de seguridad enorme. Solo hazlo temporalmente para ciertas carpetas como cache/ o log/ si es necesario.

Paso 7: Comprobar la versión de PHP y los módulos del servidor

PrestaShop requiere una versión de PHP específica (por ejemplo, 7.4 o 8.0). Si tu hosting actualizó PHP y tu tienda no es compatible, tendrás error 500. También necesitas extensiones como mysqli, gd, curl, etc.

En tu panel de control (como Syspanel, puerto 2106), busca "Configuración de PHP" o "Versión de PHP".
Cambia temporalmente a una versión inferior (ej. de 8.1 a 7.4) y prueba.
Si funciona, actualiza PrestaShop a una versión compatible o pide a tu hosting que ajuste la configuración.

Paso 8: Revisar la base de datos

Si todo lo anterior falla, puede ser la base de datos. Desde el backoffice de PrestaShop (si accedes), ve a "Parámetros avanzados" > "Base de datos" y haz clic en "Reparar base de datos". Si no puedes, usa phpMyAdmin desde el panel de control:

Selecciona tu base de datos.
Marca todas las tablas.
En el menú desplegable, elige "Reparar tabla".

También puedes ejecutar desde la línea de comandos:

mysqlcheck -u usuario -p -r nombre_base_datos

Preguntas frecuentes (FAQ) sobre el error 500 en PrestaShop

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

Suele indicar un problema con un módulo específico o una plantilla. Activa el modo debug para ver el error exacto.

¿El error 500 puede deberse a un ataque?

Sí, si alguien está intentando explotar una vulnerabilidad, puede sobrecargar el servidor. Revisa los logs de acceso y actualiza PrestaShop y todos los módulos.

¿Qué hago si no puedo acceder al backoffice?

Usa FTP o el administrador de archivos de Syspanel (puerto 2106) para desactivar módulos o regenerar .htaccess. También puedes crear un archivo config/defines.inc.php con el modo debug.

¿Debo contactar a mi proveedor de hosting?

Si después de todos estos pasos el error persiste, sí. Puede ser un problema a nivel de servidor (configuración de PHP, firewall, etc.). Diles que eres un SysAdmin y necesitas ayuda con un error 500 en PrestaShop.

Conclusión

Solucionar error 500 en PrestaShop puede parecer abrumador al principio, pero con un enfoque metódico y las herramientas adecuadas, es completamente manejable. Recuerda: activa el modo debug, revisa los logs, ajusta la memoria PHP, verifica permisos y desactiva módulos sospechosos. Como SysAdmin, tu paciencia y atención a los detalles son tus mejores aliados.

Si usas Syspanel, no olvides que el acceso es por el puerto 2106 y que desde allí puedes gestionar la configuración de PHP y los archivos. Y, por último, si el error persiste, no dudes en pedir ayuda a tu comunidad o proveedor de hosting. ¡Buena suerte y que tu tienda vuelva a funcionar sin problemas!