Cómo solucionar el error 500 en PrestaShop: Guía práctica

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

Cuando visitas tu tienda online y, de repente, te encuentras con una página en blanco o un mensaje que dice "Error 500: Internal Server Error", es normal que sientas un pequeño ataque de pánico. No te preocupes, es uno de los problemas más comunes en el mundo del hosting y, en la mayoría de los casos, tiene solución sin necesidad de ser un experto en programación.

Un error 500 en PrestaShop significa que el servidor donde está alojada tu tienda ha encontrado un problema interno que le impide procesar la solicitud. Es un error genérico, lo que significa que no te dice exactamente qué ha fallado, pero sí te indica que algo en la configuración, los archivos o el entorno del servidor no está funcionando correctamente.

Las causas más frecuentes suelen ser:

Archivos .htaccess corruptos o con reglas incorrectas.
Problemas de permisos en archivos o carpetas.
Falta de memoria PHP (límite de memoria agotado).
Módulos o temas incompatibles con tu versión de PrestaShop.
Errores en el archivo de configuración config/settings.inc.php.
Problemas con la versión de PHP instalada en tu servidor.

En esta guía completa vamos a repasar paso a paso cómo solucionar estos problemas, desde los más sencillos hasta los más técnicos, para que puedas recuperar tu tienda cuanto antes.

Paso 1: Activa el modo de depuración (Debug Mode) para ver el error real

El primer paso para solucionar un error 500 en PrestaShop es descubrir qué está fallando exactamente. Para ello, PrestaShop incluye un modo de depuración que muestra el error específico en lugar de la página en blanco.

¿Cómo activar el modo debug?

Accede a tu panel de control de hosting (por ejemplo, Syspanel, el cual encontrarás en el puerto 2106) y abre el Administrador de archivos o usa un cliente FTP como FileZilla.

Busca el archivo config/defines.inc.php en la raíz de tu instalación de PrestaShop. Ábrelo con un editor de texto y busca esta línea:

define('_PS_MODE_DEV_', false);

Cámbiala por:

define('_PS_MODE_DEV_', true);

Guarda el archivo y sube los cambios. Ahora recarga tu tienda. En lugar del error 500 genérico, verás un mensaje más descriptivo que indica el archivo y la línea exacta donde se produce el problema.

[TIP] Anota ese mensaje de error, te será muy útil para los siguientes pasos. Si no entiendes el error, no pasa nada, sigue leyendo porque las soluciones más comunes están en esta guía.

Cuando termines de depurar, no olvides volver a poner false para no mostrar información sensible a los visitantes.

Paso 2: Revisa y regenera el archivo .htaccess

El archivo .htaccess es uno de los principales sospechosos cuando aparece un error 500. Este archivo controla las reglas de reescritura de URL, redirecciones y otros parámetros del servidor. Si contiene una línea incorrecta o está dañado, el servidor puede responder con un error 500.

Solución rápida: Renombrar el archivo

Desde tu panel de control o FTP, localiza el archivo .htaccess en la raíz de tu instalación de PrestaShop.

Renómbralo a algo como .htaccess_old o simplemente bórralo (si lo borras, PrestaShop lo regenerará automáticamente).

Ahora ve al panel de administración de tu tienda (si puedes acceder) y navega a Parámetros avanzados > Rendimiento. En la sección Reglas de reescritura de URL, haz clic en Guardar para forzar la regeneración del archivo .htaccess.

Si no puedes acceder al panel de administración, puedes crear un archivo .htaccess vacío y subirlo. Luego, intenta acceder a tu tienda para ver si el error desaparece.

[WARNING] Si utilizas una configuración de servidor Nginx, el archivo .htaccess no se utiliza. En ese caso, el problema puede estar en la configuración de Nginx. Sin embargo, la mayoría de los hostings compartidos usan Apache, así que esta solución aplica en la mayoría de los casos.

Paso 3: Verifica los permisos de archivos y carpetas

Los permisos incorrectos son otra causa muy común de errores 500. PrestaShop necesita permisos específicos para leer y escribir archivos. Si algún archivo o carpeta tiene permisos demasiado restrictivos (o demasiado abiertos), el servidor puede fallar.

Permisos recomendados:

Carpetas: 755
Archivos: 644
Carpeta config/: 755 (aunque algunos entornos piden 775)
Carpeta cache/: 755 (a veces 775)
Archivo config/settings.inc.php: 644

Puedes cambiar los permisos desde el Administrador de archivos de tu hosting o mediante FTP. En FileZilla, haz clic derecho sobre el archivo o carpeta y selecciona Permisos de archivo.

Cómo cambiar permisos de forma masiva

Si tienes muchos archivos, puedes usar el comando find en la terminal de tu servidor (si tienes acceso SSH):

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

[INFO] Si no sabes qué permisos tiene tu servidor, contacta con tu proveedor de hosting. Ellos pueden decirte si tu entorno requiere permisos especiales.

Paso 4: Aumenta el límite de memoria PHP

PrestaShop es una plataforma exigente, especialmente si tienes muchos módulos o un catálogo grande. Si el límite de memoria PHP es demasiado bajo, el servidor puede agotar la memoria y mostrar un error 500.

¿Cómo aumentar el límite de memoria?

Puedes hacerlo de dos maneras:

Desde el archivo php.ini (si tu hosting te permite editarlo):

memory_limit = 256M
max_execution_time = 120

Desde el archivo .htaccess (si no tienes acceso al php.ini), añade estas líneas al final:

php_value memory_limit 256M
php_value max_execution_time 120

Desde el archivo config/settings.inc.php de PrestaShop, añade esta línea justo después de la apertura de PHP:

ini_set('memory_limit', '256M');

[TIP] Si no sabes qué límite tienes actualmente, crea un archivo info.php con el contenido <?php phpinfo(); ?> y súbelo a la raíz. Luego accede a tudominio.com/info.php para ver la configuración de PHP. No olvides borrarlo después por seguridad.

Paso 5: Revisa los módulos y temas instalados

Un módulo o tema recién instalado (o actualizado) puede ser el culpable del error 500. Especialmente si la instalación se interrumpió o si el módulo no es compatible con tu versión de PrestaShop.

Solución: Desactivar módulos desde la base de datos

Si no puedes acceder al panel de administración, puedes desactivar todos los módulos desde la base de datos.

Accede a phpMyAdmin desde tu panel de control (como Syspanel).
Selecciona la base de datos de tu PrestaShop.
Busca la tabla ps_module (el prefijo puede variar, pero suele ser ps_).
Ejecuta esta consulta SQL:

UPDATE ps_module SET active = 0;

Esto desactivará todos los módulos. Luego intenta acceder a tu tienda. Si el error desaparece, el problema era uno de los módulos. Actívalos uno a uno desde el back office para encontrar al culpable.

[WARNING] Esta solución desactiva todos los módulos, incluidos los necesarios para el funcionamiento básico. No te preocupes, PrestaShop seguirá funcionando, pero tendrás que reactivar los módulos esenciales (como el de pago o envío) manualmente.

Paso 6: Verifica la versión de PHP en tu servidor

PrestaShop es sensible a la versión de PHP. Si tu versión es demasiado antigua o demasiado nueva, pueden aparecer errores 500.

Versiones recomendadas según la versión de PrestaShop:

PrestaShop 1.6: PHP 5.6 a 7.1
PrestaShop 1.7: PHP 7.1 a 7.4
PrestaShop 8.x: PHP 7.4 a 8.1

Puedes cambiar la versión de PHP desde el panel de control de tu hosting. En Syspanel, busca la sección Versión de PHP o Gestor de PHP y selecciona la más adecuada.

[INFO] Si tu hosting usa PHP 8.2 o superior y tienes PrestaShop 1.6, es muy probable que encuentres errores. En ese caso, considera actualizar tu tienda o cambiar la versión de PHP a una compatible.

Paso 7: Revisa el archivo de configuración de PrestaShop

El archivo config/settings.inc.php contiene la configuración de conexión a la base de datos y otros parámetros esenciales. Si está dañado o tiene errores, el error 500 es casi seguro.

Qué comprobar:

Que las credenciales de la base de datos sean correctas (usuario, contraseña, nombre de la BD).
Que la ruta a los archivos sea correcta.
Que no haya caracteres extraños o espacios al principio o al final del archivo.

Si sospechas que este archivo está dañado, puedes renombrarlo (por ejemplo, a settings.inc.php.bak) y ejecutar el instalador de PrestaShop (accediendo a /install) para regenerarlo. Esto es un poco más avanzado, pero es una solución efectiva.

Paso 8: Comprueba los logs del servidor

Si después de todos estos pasos el error persiste, es hora de mirar los logs del servidor. Estos archivos registran todos los errores que ocurren en tu sitio y te darán una pista exacta de qué está fallando.

Dónde encontrar los logs:

En Syspanel, busca la sección Registros o Logs.
También puedes acceder por FTP a la carpeta var/logs/ de PrestaShop (en versiones 1.7+) o a la carpeta log/ (en versiones 1.6).

Busca los archivos .log y ábrelos con un editor de texto. Busca la fecha y hora en la que ocurrió el error. El mensaje de error te indicará el archivo y la línea exacta del problema.

[TIP] Si no entiendes los logs, copia el mensaje de error y búscalo en Google. Es muy probable que alguien más haya tenido el mismo problema y haya compartido la solución.

Resumen rápido de soluciones

Activa el modo debug para ver el error exacto.
Renombra o borra el .htaccess para regenerarlo.
Revisa los permisos de archivos y carpetas.
Aumenta la memoria PHP a 256M o más.
Desactiva módulos sospechosos desde la base de datos.
Cambia la versión de PHP a una compatible.
Revisa el archivo de configuración de PrestaShop.
Consulta los logs del servidor para más detalles.

Preguntas frecuentes (FAQ)

¿Por qué me sale un error 500 solo en algunas páginas?

Si el error aparece solo en ciertas páginas (como el carrito o la ficha de producto), es probable que el problema esté en un módulo específico que se ejecuta en esas páginas. Desactiva los módulos uno a uno para identificarlo.

¿Puedo evitar el error 500 en el futuro?

Sí, siguiendo estas buenas prácticas:

Mantén PrestaShop, los módulos y el tema siempre actualizados.
Realiza copias de seguridad periódicas.
No instales módulos de fuentes no confiables.
Revisa los logs regularmente para detectar problemas antes de que se conviertan en errores graves.

¿Qué hago si nada de esto funciona?

Si has probado todos los pasos y el error persiste, te recomiendo contactar con tu proveedor de hosting. Ellos pueden revisar los logs del servidor a nivel más profundo y verificar si hay problemas de configuración en el servidor que no puedes controlar desde el panel.

Conclusión

El error 500 en PrestaShop puede ser frustrante, pero como has visto, tiene solución. La clave está en identificar la causa raíz y aplicar la corrección adecuada. Con esta guía paso a paso, tendrás las herramientas necesarias para resolver el problema en la mayoría de los casos.

Recuerda que si tu hosting es Syspanel, puedes acceder a todas las herramientas necesarias (administrador de archivos, phpMyAdmin, logs, etc.) desde el puerto 2106. No dudes en explorar el panel y familiarizarte con él, te ahorrará muchos dolores de cabeza.

Espero que esta guía te haya sido útil. Si tienes alguna duda o sugerencia, no dudes en dejar un comentario. ¡Buena suerte con tu tienda!