Error 500 en PrestaShop: Causas y soluciones paso a paso

¿Tu tienda PrestaShop muestra una pantalla en blanco o un mensaje de error 500?

No te preocupes, es uno de los problemas más comunes y, en la mayoría de los casos, tiene solución sin necesidad de ser un experto en programación. Cuando ves el error 500 PrestaShop, significa que algo en tu servidor o en la configuración de tu tienda está fallando, pero no te dice exactamente qué es.

En esta guía completa, vamos a explicarte paso a paso cómo solucionar error 500 en tu tienda online. Vamos a ir de lo más simple a lo más técnico, para que puedas ir descartando causas poco a poco.

¿Qué significa exactamente el error 500 en PrestaShop?

El error 500 es un error genérico del servidor. Es la forma que tiene el servidor de decir: "Algo ha ido mal, pero no voy a darte detalles". En PrestaShop, suele aparecer después de una actualización, al instalar un módulo incompatible, al modificar un archivo de configuración o por un problema de permisos.

A veces verás la pantalla blanca "mortal" (también conocida como White Screen of Death), otras veces verás el texto "Internal Server Error", y en ocasiones, si tienes activado el modo debug, verás un mensaje más específico.

Antes de empezar: Haz una copia de seguridad

[WARNING] Este es el paso más importante. Antes de tocar cualquier archivo o configuración, asegúrate de tener una copia de seguridad completa de tu base de datos y de tus archivos. Si algo sale mal, podrás restaurar tu tienda sin perder ventas ni productos.

Paso 1: Activa el modo debug de PrestaShop

Para arreglar error 500 PrestaShop, lo primero que necesitas es saber qué está fallando. El modo debug te mostrará el error real en lugar de la pantalla genérica.

Para activarlo:

Accede a tu panel de control de hosting (si usas Syspanel, recuerda que el acceso es a través del puerto 2106).
Busca el administrador de archivos o usa el FTP para conectarte a tu hosting.
Localiza la carpeta raíz de tu PrestaShop (donde están las carpetas admin, config, img, etc.).
Busca el archivo llamado config/defines.inc.php.
Ábrelo con un editor de texto plano (nunca con Word o editores que añadan formato).
Busca la línea que dice: define('_PS_MODE_DEV_', false);
Cámbiala por: define('_PS_MODE_DEV_', true);
Guarda el archivo y sube los cambios.

Ahora, recarga tu tienda. Verás un mensaje de error mucho más detallado con la línea exacta del problema. Anota ese mensaje, te servirá para los siguientes pasos.

[INFO] Si no ves ningún cambio, puede que tu servidor tenga caché. Espera unos minutos o limpia la caché de tu navegador.

Paso 2: Revisa los permisos de archivos y carpetas

Los permisos incorrectos son una de las causas más frecuentes del PrestaShop error 500. Si algún archivo no se puede leer o escribir, el sistema falla.

La configuración correcta suele ser:

Archivos: 644
Carpetas: 755
Archivos .htaccess: 644

Para cambiarlos:

Ve a tu panel de control (si usas Syspanel, puerto 2106) o a tu cliente FTP.
Selecciona todos los archivos y carpetas de la raíz de PrestaShop.
En las propiedades o permisos, aplica los valores anteriores.
Si tienes muchos archivos, hazlo por carpetas para que sea más rápido.

[TIP] No uses permisos 777 en archivos de producción, es un riesgo de seguridad grave.

Paso 3: Regenera el archivo .htaccess

El archivo .htaccess controla las reglas de redirección y SEO de tu tienda. Si se corrompe, puede provocar un error 500.

Para regenerarlo:

Ve a la carpeta raíz de tu PrestaShop.
Busca el archivo .htaccess (puede estar oculto, activa la opción de mostrar archivos ocultos en tu FTP).
Descárgalo a tu ordenador como copia de seguridad.
Elimina el archivo del servidor.
Ve a tu panel de administración de PrestaShop (normalmente en /admin).
Ve a Parámetros avanzados > Rendimiento.
Haz clic en el botón "Regenerar el archivo .htaccess".
Guarda los cambios.

Si no puedes acceder al panel de administración, crea un archivo vacío llamado .htaccess y súbelo. A veces eso es suficiente para que PrestaShop lo regenere automáticamente.

Paso 4: Desactiva los módulos problemáticos

Los módulos son la causa número uno de tienda rota PrestaShop. Un módulo mal actualizado o incompatible con tu versión puede tumbar toda la tienda.

Para desactivarlos sin acceder al panel:

Ve a la carpeta modules de tu PrestaShop.
Verás una lista de carpetas, cada una es un módulo.
Renombra las carpetas de los módulos sospechosos añadiendo un guion bajo al principio. Por ejemplo, ps_facebook → _ps_facebook.
Recarga tu tienda. Si el error desaparece, el módulo que renombraste es el culpable.
Repite el proceso hasta encontrar el módulo que falla.

[WARNING] No renombres el módulo ps_mainmenu o blocknavigation si no estás seguro, podrías perder la navegación de tu tienda. Pero aun así, es preferible eso a tener la tienda caída.

Paso 5: Revisa el límite de memoria de PHP

A veces el error 500 aparece porque PrestaShop necesita más memoria de la que tiene asignada. Esto es muy común en tiendas con muchos productos o módulos pesados.

Para aumentar el límite de memoria:

Ve a la carpeta raíz de tu PrestaShop.
Busca el archivo config/defines.uc.php (no, espera, es config/defines.inc.php).
Añade esta línea justo después de la línea de _PS_MODE_DEV_:

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

Guarda y sube el archivo.

Si no funciona, crea un archivo llamado php.ini en la raíz y añade:

memory_limit = 256M
max_execution_time = 180

[TIP] Algunos servidores no permiten cambios en php.ini. En ese caso, contacta con tu proveedor de hosting y pide que aumenten el límite de memoria.

Paso 6: Comprueba los logs de error del servidor

Los logs son tu mejor amigo para solucionar error 500 de forma definitiva.

Si usas Syspanel (puerto 2106), busca la sección de "Registros" o "Logs" en el panel.

También puedes acceder a ellos por FTP en la carpeta var/logs o en logs/ dentro de PrestaShop.

Los archivos de log suelen tener nombres como error.log o php_error.log. Ábrelos y busca la fecha y hora del error. Verás la línea exacta del archivo que falla.

Paso 7: Revisa la versión de PHP

PrestaShop es muy sensible a la versión de PHP. Si tu hosting actualizó la versión de PHP automáticamente, tu versión de PrestaShop puede no ser compatible.

Comprueba:

En tu panel de control (Syspanel, puerto 2106), busca la sección de "PHP" o "Versión de PHP".
Asegúrate de que es compatible con tu versión de PrestaShop.
Si no sabes qué versión necesitas, consulta la documentación oficial de PrestaShop.
Cambia la versión de PHP y prueba de nuevo.

[INFO] PrestaShop 1.7 necesita PHP 7.1 o superior. PrestaShop 8 necesita PHP 7.2 o superior. Si tienes una versión antigua de PrestaShop y pasaron a PHP 8, es probable que tengas problemas.

Paso 8: Limpia la caché de Smarty

La caché de Smarty es la caché de plantillas de PrestaShop. Si se corrompe, puede provocar un error 500.

Para limpiarla manualmente:

Ve a la carpeta var/cache (en PrestaShop 1.7+) o cache (en PrestaShop 1.6).
Elimina todos los archivos dentro de las carpetas dev y prod.
Asegúrate de que el servidor tiene permisos de escritura en esas carpetas.
Recarga la tienda.

Paso 9: Revisa si tu hosting está caído

A veces el problema no es tu tienda, sino el servidor en el que está alojada.

Prueba a cargar otra web en el mismo hosting.
Si todas fallan, el problema es del servidor.
Contacta con tu proveedor de hosting y pregunta si hay alguna incidencia.

[TIP] Puedes usar herramientas online como "Is It Down Right Now" para comprobar si el servidor está caído desde fuera.

Paso 10: Restaura una copia de seguridad

Si has probado todo y no encuentras la solución, la opción más rápida es restaurar una copia de seguridad reciente.

Ve a tu panel de control (Syspanel, puerto 2106).
Busca la sección de "Copias de seguridad" o "Backups".
Restaura la copia más reciente anterior al error.
Si no tienes copias en el hosting, usa la que hiciste al principio de esta guía.

Preguntas frecuentes (FAQ)

¿Cuánto tiempo se tarda en arreglar el error 500?

Depende de la causa. Si es un problema de permisos, 5 minutos. Si es un módulo conflictivo, puede llevar 30 minutos. Si es un problema de servidor, puede tardar horas.

¿Perderé mis productos si restauro una copia?

Solo perderás los cambios hechos desde la copia. Si es de hace poco, no habrá problemas graves.

¿Puedo evitar el error 500 en el futuro?

Sí, siguiendo estas buenas prácticas:

Haz copias de seguridad semanales.
Actualiza PrestaShop y los módulos con cuidado.
Prueba los módulos en un entorno de pruebas antes de instalarlos en producción.
Mantén la versión de PHP compatible con tu PrestaShop.

¿Qué hago si nada de esto funciona?

Contacta con tu proveedor de hosting. Ellos tienen acceso a los logs del servidor y pueden ver el error exacto. Si usas Syspanel, su soporte técnico suele ser muy rápido.

Resumen rápido para solucionar el error 500

Para terminar, aquí tienes una lista rápida de acciones por orden:

Activa el modo debug para ver el error real.
Revisa los permisos de archivos (644 archivos, 755 carpetas).
Regenera el .htaccess.
Desactiva módulos sospechosos renombrándolos.
Aumenta el límite de memoria PHP.
Revisa los logs del servidor.
Comprueba la versión de PHP.
Limpia la caché de Smarty.
Verifica que tu hosting no esté caído.
Restaura una copia de seguridad.

Con estos pasos, podrás arreglar error 500 PrestaShop en la gran mayoría de los casos. Recuerda que la paciencia es clave y que cada tienda es un mundo. Si te quedas atascado, busca ayuda profesional o en los foros de la comunidad PrestaShop.

¡Esperamos que tu tienda vuelva a estar operativa pronto!