Solucionar error 500 en PrestaShop: Causas y soluciones

¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto, seguramente te has topado con el temido error 500 en tu tienda PrestaShop. No te preocupes, es el problema más común en el mundo del hosting y, por suerte, en la mayoría de los casos se puede arreglar sin ser un experto. En esta guía extensa te voy a explicar paso a paso cómo solucionar el error 500 en PrestaShop, desde lo más básico hasta ajustes un poco más técnicos. Vamos a hacer que tu tienda vuelva a funcionar.

¿Qué es el error 500 en PrestaShop y por qué aparece?

El error 500, también conocido como "Error interno del servidor", es una respuesta genérica que da el servidor cuando algo falla, pero no puede especificar exactamente qué. En PrestaShop, las causas más frecuentes suelen ser:

Archivos .htaccess corruptos o mal configurados.
Módulos incompatibles o mal instalados.
Problemas de permisos en archivos o carpetas.
Límite de memoria de PHP agotado.
Errores en el archivo de configuración settings.inc.php.
Falta de espacio en disco o cuota de hosting excedida.

No te asustes, vamos a revisar cada una de estas causas con pasos muy claros.

Paso 1: Lo primero, reinicia y borra caché

Antes de meterte en archivos, prueba lo más simple:

Accede a tu panel de control (cPanel, Syspanel, Plesk, etc.). Si usas Syspanel, recuerda que el puerto de acceso es el 2106 (ejemplo: tudominio.com:2106).
Reinicia el servicio web (Apache o Nginx). En la mayoría de paneles hay un botón de "Reiniciar" o "Restart".
Borra la caché de PrestaShop. Si aún puedes acceder al back office, ve a Parámetros Avanzados > Rendimiento y limpia la caché. Si no, tendrás que hacerlo manualmente: conecta por FTP o desde el administrador de archivos y elimina la carpeta /var/cache dentro del directorio de PrestaShop.

[TIP] A veces el error 500 es temporal. Un simple reinicio del servidor o borrar la caché lo soluciona. No subestimes este paso.

Paso 2: Verifica y regenera el archivo .htaccess

El archivo .htaccess es uno de los grandes culpables. Si está dañado, tu tienda no cargará.

¿Cómo solucionarlo?

Conéctate por FTP o desde el administrador de archivos de tu panel (en Syspanel, ve a Archivos > Administrador de archivos).
Busca el archivo .htaccess en la raíz de tu PrestaShop (normalmente en public_html o www).
Renómbralo a algo como .htaccess_backup (así lo respaldas).
Ve al back office de PrestaShop (si puedes acceder) y ve a Parámetros Avanzados > SEO y URLs. Haz clic en Guardar sin cambiar nada. Esto regenera un nuevo .htaccess.
Si no puedes acceder al back office, crea un archivo .htaccess vacío (solo con el contenido mínimo que te doy abajo) y súbelo.

Contenido mínimo para un .htaccess básico de PrestaShop (solo para que funcione, luego lo regenerarás):

# ~~start~~ No modifiques este comentario, PrestaShop lo usa
<IfModule mod_rewrite.c>
    RewriteEngine on
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^(.*)$ index.php [QSA,L]
</IfModule>
# ~~end~~

[WARNING] No copies y pegues esto sin más. Si tu PrestaShop tiene configuraciones especiales (multiidioma, SSL forzado, etc.), necesitarás regenerarlo desde el back office. Este es solo un parche temporal.

Paso 3: Revisa los permisos de archivos y carpetas

Los permisos incorrectos son otra causa frecuente. PrestaShop necesita que ciertos archivos y carpetas tengan permisos específicos.

Permisos recomendados:

Archivos: 644 (lectura y escritura para el usuario, solo lectura para el grupo y otros).
Carpetas: 755 (lectura, escritura y ejecución para el usuario, solo lectura y ejecución para grupo y otros).
Carpetas especiales: /config, /cache, /log, /img, /mails, /modules, /themes, /translations, /upload, /download deben tener permisos 755 o 777 temporalmente para que PrestaShop pueda escribir.

¿Cómo hacerlo?

Desde tu panel de control, usa el Administrador de archivos o conéctate por FTP.
Selecciona toda la carpeta de PrestaShop.
Cambia los permisos a 755 para carpetas y 644 para archivos. Muchos paneles tienen una opción "Recursivo" para aplicarlo a todo.
Si después de esto el error persiste, dale permisos 777 temporalmente a la carpeta /cache y /log. Luego, cuando todo funcione, vuelve a 755.

[INFO] Algunos paneles como Syspanel permiten cambiar permisos de forma masiva desde la sección Archivos > Permisos. Busca la opción "Aplicar a subdirectorios".

Paso 4: Aumenta el límite de memoria de PHP

PrestaShop es exigente en recursos. Si tu tienda tiene muchos módulos, productos o visitas, puede exceder el límite de memoria PHP.

¿Dónde se configura?

Desde el panel de control: Busca la sección "PHP" o "Configuración de PHP". En Syspanel, está en Servicios > PHP.
Busca el parámetro memory_limit y cámbialo a al menos 256M o 512M.
También es recomendable aumentar max_execution_time a 300 segundos y upload_max_filesize a 64M.

Si no puedes desde el panel, crea un archivo php.ini en la raíz de tu PrestaShop con este contenido:

memory_limit = 256M
max_execution_time = 300
upload_max_filesize = 64M
post_max_size = 64M

[TIP] Si tu hosting usa PHP-FPM (como Syspanel), a veces los cambios en php.ini se hacen desde la configuración del pool de PHP. En Syspanel, ve a Servicios > PHP y edita la versión de PHP que uses.

Paso 5: Desactiva módulos problemáticos

Un módulo defectuoso o incompatible con tu versión de PrestaShop puede generar el error 500.

¿Cómo desactivarlos si no puedes acceder al back office?

Conéctate por FTP o administrador de archivos.
Ve a la carpeta /modules dentro de tu PrestaShop.
Renombra la carpeta del módulo sospechoso añadiendo _old al final. Por ejemplo, supermodulo -> supermodulo_old.
Prueba si la tienda carga. Si funciona, ese módulo es el culpable. Puedes eliminarlo o buscar una versión actualizada.

Si no sabes cuál es el módulo problemático, renombra todos los módulos de terceros (los que no son nativos de PrestaShop) a la vez. Luego, ve activándolos uno por uno desde el back office.

[WARNING] No renombres módulos oficiales de PrestaShop (como ps_mainmenu, ps_searchbar, etc.). Solo toca los que hayas instalado tú.

Paso 6: Revisa el archivo settings.inc.php

Este archivo contiene la configuración de la base de datos. Si está corrupto o tiene datos incorrectos, tu tienda no arrancará.

¿Cómo verificarlo?

Ve a la carpeta /config de tu PrestaShop.
Abre el archivo settings.inc.php con un editor de texto (Bloc de notas, Sublime Text, etc.).
Busca las líneas que empiezan con define('_DB_SERVER_',, define('_DB_NAME_',, define('_DB_USER_',, define('_DB_PASSWD_',.
Verifica que los datos sean correctos (servidor de base de datos, nombre, usuario y contraseña). Si no estás seguro, contacta a tu proveedor de hosting o revisa la sección de bases de datos en tu panel (en Syspanel, ve a Bases de Datos).

[INFO] A veces el servidor de base de datos cambia (por ejemplo, de localhost a 127.0.0.1 o a un nombre como mysql.tudominio.com). Ajusta ese valor.

Paso 7: Activa el modo debug de PrestaShop

El error 500 es muy genérico. Para ver el error real, activa el modo debug de PrestaShop. Esto te mostrará una descripción más detallada.

¿Cómo hacerlo?

Conéctate por FTP.
Abre el archivo /config/defines.inc.php.
Busca la línea: define('_PS_MODE_DEV_', false);
Cámbiala a: define('_PS_MODE_DEV_', true);
Guarda y vuelve a cargar tu tienda. Ahora verás un mensaje de error específico, como "Fatal error: Allowed memory size exhausted" o "Class not found".

[WARNING] No dejes el modo debug activado en una tienda en producción, ya que muestra información sensible. Cuando termines, vuelve a poner false.

Paso 8: Verifica el espacio en disco y cuota de hosting

A veces el error 500 aparece porque se ha llenado el disco o la cuota de archivos (inodes).

¿Cómo revisarlo?

En Syspanel: Ve a Estadísticas > Uso del disco. Allí verás cuánto espacio y cuántos inodes estás usando.
En cPanel: Busca "Uso del disco" o "Estadísticas".
Si estás cerca del límite, libera espacio: elimina logs viejos, copias de seguridad innecesarias, imágenes temporales, etc.

Paso 9: Restaura una copia de seguridad

Si has llegado hasta aquí y nada funciona, es posible que el problema sea más grave (archivos del core corruptos, actualización fallida, etc.). Restaurar una copia de seguridad reciente es la solución más rápida.

¿Cómo restaurar?

Desde tu panel de control, busca la opción "Copias de seguridad" o "Backups". En Syspanel, está en Seguridad > Copias de seguridad.
Elige una copia de seguridad anterior a cuando apareció el error.
Restaura tanto los archivos como la base de datos.

[TIP] Si no tienes copia de seguridad, contacta a tu proveedor de hosting. Muchos ofrecen backups automáticos de los últimos 7 días.

Preguntas frecuentes (FAQ)

¿El error 500 puede deberse a un plugin de pago?

Sí, los módulos de pago suelen ser pesados y a veces incompatibles con la versión de PHP. Sigue el paso 5 para desactivarlos temporalmente.

¿Puedo solucionarlo sin acceder al back office?

Sí, todos los pasos que te he dado (excepto regenerar el .htaccess desde el back office) se pueden hacer por FTP o desde el panel de control. Si no puedes regenerar el .htaccess, usa el archivo mínimo que te di.

¿En Syspanel cómo accedo al administrador de archivos?

En Syspanel, ve a Archivos > Administrador de archivos. Recuerda que el puerto de acceso es el 2106. Allí puedes navegar, editar y cambiar permisos.

¿Qué hago si el error persiste después de todo?

Si has seguido todos los pasos y el error 500 sigue, el problema puede ser del servidor (configuración de Apache/Nginx, módulos del servidor desactivados, etc.). Contacta a tu soporte técnico de hosting y diles que has revisado permisos, .htaccess y memoria PHP. Ellos podrán revisar los logs del servidor (error_log) para darte una pista más precisa.

Conclusión

El error 500 en PrestaShop es frustrante, pero casi siempre tiene solución. Empieza por lo más simple (reiniciar, borrar caché), luego revisa el .htaccess y los permisos, y si no, profundiza en módulos y configuración PHP. Recuerda que en Syspanel (puerto 2106) tienes herramientas muy útiles como el administrador de archivos y la configuración de PHP. Y si todo falla, una copia de seguridad te salvará.

Espero que esta guía te haya sido de ayuda. Si tienes más dudas, déjalas en los comentarios. ¡Tu tienda volverá a funcionar en poco tiempo!