🎨 Sysprovider Code
Sysprovider LogoWiki
🇪🇸Hosting español para ecommerce

Solución de errores comunes de PrestaShop: 500, 503 y más

Actualizado el 4 de diciembre de 2025

Introducción: Cuando tu tienda PrestaShop se bloquea

Si estás leyendo esto, probablemente te has encontrado con una pantalla en blanco, un mensaje de error o, directamente, una página que no carga. Los errores prestashop son más comunes de lo que parece, y la buena noticia es que la mayoría tienen solución.

Cuando hablamos de error 500 prestashop o un error 503, el problema suele estar en el servidor, en la configuración de archivos o en algún módulo conflictivo. No te asustes: no necesitas ser un experto en programación para resolverlo. Aquí te explico, paso a paso y sin tecnicismos, cómo identificar y arreglar los fallos más habituales.

¿Qué significa cada error?

Antes de lanzarnos a resolver, es importante saber qué nos está diciendo la tienda. Cada número tiene un significado:

  • Error 500 (Internal Server Error): El servidor entiende la petición, pero algo falla en su interior. Es un error genérico que puede deberse a un archivo .htaccess corrupto, a un módulo roto o a un problema de permisos.
  • Error 503 (Service Unavailable): El servidor está en mantenimiento o colapsado. En PrestaShop, suele aparecer cuando la tienda está en modo mantenimiento o cuando el servidor está sobrecargado.
  • Error 502 (Bad Gateway): El servidor intermedio no recibe una respuesta válida del servidor principal. Muy común si usas un proxy o un CDN.
  • Pantalla blanca: A veces no hay mensaje, solo una página vacía. Esto indica un error de PHP que está oculto, y hay que activar los logs para verlo.

Error 500 en PrestaShop: causas y soluciones prácticas

El error 500 prestashop es el más temido. Te dejo una lista de causas frecuentes y cómo atacarlas.

1. Archivo .htaccess corrupto o desactualizado

Este archivo es el "director de tráfico" de tu tienda. Si se corrompe, todo falla.

Solución:

  1. Entra a tu hosting por FTP o por el administrador de archivos.
  2. Busca la carpeta raíz de PrestaShop (donde están config, cache, img, etc.).
  3. Localiza el archivo .htaccess. Si no lo ves, activa la opción de "mostrar archivos ocultos".
  4. Renómbralo a .htaccess.bak (esto lo desactiva sin borrarlo).
  5. Ve a tu panel de administración de PrestaShop: Parámetros avanzados > Rendimiento.
  6. Pulsa "Regenerar archivo .htaccess" (si la opción no aparece, guarda cualquier ajuste para forzar la regeneración).
  7. Si el error desaparece, genial. Si no, restaura el archivo original.

[TIP] Si no puedes acceder al panel de administración, edita el .htaccess con un editor de texto plano y borra todo su contenido. Luego, intenta cargar la tienda. Si funciona, el problema era una directiva inválida.

2. Permisos de archivos incorrectos

PrestaShop necesita permisos específicos para leer y escribir archivos. Si están mal configurados, el servidor no puede ejecutar el código.

Solución ideal:

  • Las carpetas deben tener permiso 755.
  • Los archivos deben tener permiso 644.
  • El archivo config/settings.inc.php debe tener 444 (solo lectura) en producción.

Puedes cambiarlos desde el administrador de archivos de tu hosting o con un cliente FTP como FileZilla (clic derecho > Permisos de archivo).

[WARNING] No pongas permisos 777 en todo. Es un riesgo de seguridad grave y muchos servidores lo bloquean automáticamente.

3. Módulos incompatibles o mal configurados

Un módulo que se actualizó mal o que no es compatible con tu versión de PrestaShop puede tumbar la tienda entera.

Solución:

  1. Accede al panel de administración (si puedes).
  2. Ve a Módulos > Módulos y servicios.
  3. Desactiva los módulos que hayas instalado o actualizado recientemente.
  4. Si el error se soluciona, reactiva uno a uno para encontrar al culpable.

¿No puedes entrar al panel?

  1. Conecta por FTP.
  2. Entra en la carpeta modules.
  3. Renombra la carpeta del módulo sospechoso añadiendo un guion bajo al principio (ej: _ps_googleanalytics).
  4. Si la tienda carga, ese era el problema.

Error 503 en PrestaShop: ¿Servidor en mantenimiento?

El error 503 es más amigable porque suele ser un estado temporal. Pero si se queda atascado, hay que actuar.

1. Modo mantenimiento activado por error

A veces, al editar ajustes, se activa el modo mantenimiento sin querer.

Solución:

  • Ve a Parámetros avanzados > Mantenimiento.
  • Desactiva el modo mantenimiento.
  • Si no puedes acceder al panel, edita la base de datos con phpMyAdmin (desde el panel de tu hosting). Busca la tabla ps_configuration y localiza el valor PS_SHOP_ENABLE. Cámbialo a 1.

[INFO] El modo mantenimiento es útil para trabajar en la tienda, pero recuerda desactivarlo al terminar. Es una de las causas más comunes de prestashop problemas de acceso.

2. Servidor sobrecargado

Si tu hosting no tiene suficientes recursos (memoria RAM o CPU), el servidor responde con un 503.

Soluciones hosting:

  • Reinicia el servidor desde el panel de control (si tienes un VPS o servidor dedicado).
  • Optimiza la memoria PHP: En el archivo config/defines.inc.php, busca define('_PS_MEMORY_LIMIT_', '256M'); y súbelo a 512M si tu plan lo permite.
  • Contacta con tu proveedor: Si el error es recurrente, quizás necesitas un plan superior o un servidor con más recursos.

3. Archivos de caché corruptos

La caché de PrestaShop puede llenarse de datos basura y provocar conflictos.

Solución:

  1. Entra por FTP a la carpeta var/cache (o cache en versiones antiguas).
  2. Borra todo el contenido de las subcarpetas dev y prod, pero no borres las carpetas en sí.
  3. Si no puedes borrar desde FTP, usa el administrador de archivos del hosting.

[TIP] Después de limpiar la caché, ve a Parámetros avanzados > Rendimiento y desactiva la caché temporalmente para ver si el problema persiste.

Otros errores comunes y cómo solucionarlos

Error 502 Bad Gateway

Este error suele aparecer cuando hay un problema con el servidor web o el proxy inverso.

Soluciones:

  • Reinicia el servidor web (Apache o Nginx) desde el panel de control.
  • Si usas Cloudflare u otro CDN, púrgalo (purge cache).
  • Revisa los logs del servidor en logs/ dentro de tu hosting.

Pantalla blanca sin mensaje

Esto es un error de PHP que está oculto. Hay que activar la visualización de errores.

Pasos:

  1. Abre el archivo config/defines.inc.php.
  2. Busca define('_PS_MODE_DEV_', false); y cámbialo a define('_PS_MODE_DEV_', true);.
  3. Guarda y recarga la tienda. Ahora verás el error exacto en pantalla.
  4. Anota el mensaje y búscalo en Google o en foros de PrestaShop. La mayoría de las veces te dirá qué archivo y línea falla.
  5. Importante: Cuando termines, vuelve a poner _PS_MODE_DEV_ en false para no exponer información sensible.

[WARNING] Activar el modo desarrollo en una tienda en producción es peligroso. Hazlo solo temporalmente y nunca lo dejes activo.

Error de conexión a la base de datos

Este error suele aparecer como "Error de conexión a la base de datos" o "Link to database cannot be established".

Causas frecuentes:

  • Contraseña de la base de datos cambiada.
  • El servidor de la base de datos está caído.
  • El archivo config/settings.inc.php tiene datos incorrectos.

Solución:

  1. Ve a tu panel de hosting y abre "Bases de datos MySQL".
  2. Comprueba que el usuario y la contraseña son correctos.
  3. En el archivo config/settings.inc.php, verifica que estos datos coinciden.
  4. Si usas un hosting compartido y has cambiado la contraseña recientemente, actualízala también en este archivo.

Herramientas y trucos para diagnosticar rápido

Cuando tengas prestashop problemas, tener un método te ahorrará horas. Aquí va mi checklist personal:

  1. Revisa el log de errores: En el panel de tu hosting, busca la sección de "Registros de errores" o "Logs". Ahí verás el error exacto de PHP.
  2. Prueba con un tema por defecto: Si el error empezó tras instalar un tema, cámbialo temporalmente al tema clásico.
  3. Desactiva todos los módulos: Como ya vimos, renombra la carpeta modules a modules_bak. PrestaShop funcionará sin módulos, y así sabrás si el problema es uno de ellos.
  4. Comprueba el espacio en disco: Si tu disco está lleno, el servidor falla. Borra logs antiguos, copias de seguridad y cachés.

[INFO] Si usas Syspanel para gestionar tu servidor, recuerda que el acceso se realiza por el puerto 2106. Desde ahí puedes reiniciar servicios, ver logs y gestionar dominios fácilmente.

Prevención: cómo evitar futuros errores

La mejor solución es la prevención. Toma nota de estos hábitos:

  • Actualiza PrestaShop y los módulos con cuidado. Hazlo de uno en uno y siempre con una copia de seguridad previa.
  • Haz copias de seguridad periódicas de los archivos y la base de datos. Guárdalas en un lugar externo.
  • No instales módulos piratas o de fuentes no oficiales. Son la principal causa de vulnerabilidades y errores.
  • Mantén el hosting actualizado: PHP, MySQL y el servidor web deben estar en versiones compatibles con tu PrestaShop.
  • Configura un entorno de pruebas (staging) para probar cambios antes de aplicarlos en producción.

Preguntas frecuentes (FAQ)

¿Por qué mi PrestaShop da error 500 después de una actualización?

Es muy común. La actualización puede haber dejado archivos de caché antiguos o módulos incompatibles. Borra la caché (var/cache) y desactiva los módulos no oficiales.

¿El error 503 siempre significa que el servidor está caído?

No. También puede ser que tengas activado el modo mantenimiento o que el servidor esté saturado. Revisa primero el modo mantenimiento en el panel.

¿Puedo arreglar el error 500 sin acceso al panel de administración?

Sí. Usa FTP o el administrador de archivos del hosting. Renombra el .htaccess, borra la caché y desactiva módulos. En la mayoría de los casos, con eso es suficiente.

¿Cuánto tiempo se tarda en solucionar un error 500?

Depende de la causa. Si es el .htaccess, en 5 minutos lo tienes. Si es un módulo conflictivo, puede llevarte 20-30 minutos. Si es un problema de servidor, tendrás que contactar con tu proveedor.

¿Debo contratar un soporte técnico profesional?

Si has probado todo esto y el error persiste, puede ser un problema de configuración del servidor más profundo. En ese caso, un técnico especializado en soluciones hosting te ahorrará tiempo y dolores de cabeza.

Conclusión

Los errores prestashop como el 500, 503 o la pantalla blanca son frustrantes, pero casi siempre tienen solución. La clave está en diagnosticar con calma: revisa los logs, prueba desactivando módulos y no temas tocar archivos si tienes una copia de seguridad.

Recuerda que tu hosting es tu aliado. Si el problema es de recursos o de configuración del servidor, no dudes en contactar con ellos. Y si gestionas tu servidor con Syspanel, recuerda que el acceso es por el puerto 2106 para tener todo bajo control.

Espero que esta guía te haya sido útil. ¡Tu tienda online volverá a funcionar en poco tiempo!

¿Necesitas ayuda?Son dos de nuestros técnicos, Agustín y Mikel, y están disponibles para resolver cualquier problema.

Hablar con ellos ahora
Agustín y Mikel