Errores Comunes en PrestaShop: 500, 503 y Página en Blanco | Soluciones

¡Hola! Si estás leyendo esto, es muy probable que hayas intentado acceder a tu tienda online y te hayas encontrado con un mensaje de error que te ha helado la sangre: un error 500, un error 503 o, lo que es peor, una página en blanco.

No te preocupes. Respira. Es uno de los sustos más comunes en el mundo del comercio electrónico y, en la gran mayoría de los casos, tiene solución. Estos errores en PrestaShop pueden deberse a un simple archivo con permisos incorrectos, a un módulo conflictivo o a un problema de memoria del servidor.

En esta guía extensa y detallada, vamos a desglosar, paso a paso y sin tecnicismos innecesarios, cómo diagnosticar y solucionar los errores prestashop más habituales. Tanto si tienes un hosting compartido como si gestionas tu propio servidor VPS, estos trucos te sacarán de un apuro. Vamos a ello.

¿Por qué aparecen estos errores? Entendiendo el problema

Antes de lanzarnos a tocar archivos, es fundamental entender qué significa cada error. No es lo mismo un error 500 que un 503, aunque a veces el origen sea similar.

Error 500 PrestaShop: El error genérico del servidor

El error 500 prestashop (Internal Server Error) es el más frustrante porque es un "cajón de sastre". Significa que algo ha fallado en el servidor, pero no te dice exactamente qué. Suele estar relacionado con:

Archivos .htaccess corruptos: Este archivo es el "libro de instrucciones" del servidor. Si se daña, todo se rompe.
Permisos de archivos incorrectos: Si un archivo tiene permisos demasiado restrictivos (por ejemplo, 000) o demasiado abiertos (777), el servidor puede negarse a ejecutarlo.
Problemas de memoria PHP: Si tu tienda necesita más memoria de la que el servidor le permite usar, se cae.
Módulos incompatibles: Un módulo mal codificado o desactualizado puede generar un conflicto fatal.
Versiones incompatibles de PHP: PrestaShop es muy sensible a la versión de PHP. Si actualizas el servidor y no tu tienda, adiós.

Error 503 PrestaShop: Servicio no disponible

El error 503 prestashop (Service Unavailable) es más específico. El servidor está funcionando, pero no puede completar tu solicitud en ese momento. Las causas más comunes son:

Modo Mantenimiento activado: Alguien (o un módulo) ha activado el modo mantenimiento y no se ha desactivado correctamente.
Servidor sobrecargado: Demasiados visitantes o procesos consumiendo recursos.
Problemas con el firewall o el balanceador de carga: A veces, el servidor bloquea la IP o hay un fallo en la configuración de red.
Fallo en el demonio de PHP-FPM: Si usas una configuración avanzada, el proceso que ejecuta PHP puede haberse detenido.

Página en blanco: El error silencioso

La página en blanco es un clásico. Te da exactamente la misma información que el error 500: ninguna. Simplemente ves un fondo blanco. Esto suele indicar que PHP ha muerto en silencio, normalmente por un error fatal de memoria o por un archivo que termina con un espacio o una línea en blanco después de la etiqueta ?>. Es la pesadilla de cualquier desarrollador.

Diagnóstico inicial: Activar el modo depuración (Debug)

Para solucionar cualquier error prestashop, necesitas que la tienda te diga qué le pasa. La solución es activar el modo "debug" o depuración. Esto hará que, en lugar de una página en blanco, veas un mensaje de error detallado con la ruta del archivo problemático.

Para ello, tienes que editar el archivo /config/defines.inc.php de tu instalación de PrestaShop. Puedes hacerlo desde el administrador de archivos de tu hosting o por FTP (FileZilla, por ejemplo).

Busca la línea que dice define('_PS_MODE_DEV_', false);.
Cámbiala a define('_PS_MODE_DEV_', true);.
Guarda el archivo y sube los cambios (si usas FTP).

[WARNING]: Esta acción expone información sensible de tu servidor. Úsala solo para diagnosticar y, en cuanto termines, vuelve a ponerla en false.

Ahora, al recargar la página, verás un mensaje como "Fatal error: ..." o "Warning: ...". Ese mensaje te dirá exactamente qué archivo está causando el problema. Anota la ruta completa del archivo y el número de línea. Es tu mapa del tesoro.

Soluciones paso a paso para el error 500 PrestaShop

Una vez que tienes el mensaje de error (o si no lo tienes), vamos a aplicar las soluciones más efectivas. Empieza por la primera y ve bajando si no funciona.

1. Regenerar el archivo .htaccess

Este es el primer paso casi siempre. El archivo .htaccess se regenera fácilmente desde el back office, pero si no puedes acceder, hay que hacerlo manualmente.

Desde el Back Office (si puedes entrar): Ve a Parámetros Avanzados > Rendimiento y haz clic en el botón "Guardar" al final de la página (sin cambiar nada). Esto fuerza la regeneración del .htaccess.
Desde FTP: Si no tienes acceso al panel de administración, descarga el archivo .htaccess de la raíz de tu PrestaShop (si existe) y renómbralo a .htaccess_bak (para hacer una copia). Luego, crea un archivo nuevo vacío llamado .htaccess y súbelo. Intenta acceder de nuevo. Si funciona, ve al back office y regenéralo desde Rendimiento.

2. Corregir los permisos de archivos y carpetas

Los permisos son cruciales. En general, los archivos deben tener permiso 644 y las carpetas 755. Los archivos que necesitan escritura (como config/settings.inc.php o la carpeta cache) pueden necesitar 664 o 775.

Puedes hacer esto desde el panel de control de tu hosting (a veces llamado "Administrador de archivos") o desde un cliente FTP.

Selecciona todos los archivos y carpetas de la raíz.
En tu cliente FTP, haz clic derecho y busca "Permisos de archivos" o "Chmod".
Pon 644 para archivos y 755 para carpetas. Si tu cliente FTP no distingue, pon 755 para todo y luego cámbialo.

[INFO]: Si tienes acceso a la terminal de tu servidor (SSH), puedes usar estos comandos:

find . -type f -exec chmod 644 {} \;
find . -type d -exec chmod 755 {} \;

3. Aumentar el límite de memoria PHP

Si el error menciona "Allowed memory size of X bytes exhausted", este es tu problema. Debes aumentar el límite de memoria.

Localiza el archivo php.ini: A veces está en la raíz de tu hosting, otras en una carpeta llamada php o similar. Si no existe, créalo.
Edita o añade la línea: memory_limit = 256M (o incluso 512M si tu hosting lo permite).
Si no encuentras php.ini: Puedes intentar crear un archivo llamado .user.ini en la raíz con la misma línea.
Último recurso: Editar el archivo .htaccess y añadir al final: php_value memory_limit 256M.

4. Desactivar todos los módulos (si es posible)

A veces un módulo es el culpable. Si puedes acceder al back office, ve a Módulos > Módulos y Servicios y desactiva todos. Luego ve activándolos uno a uno para ver cuál rompe la tienda.

Si no puedes acceder al back office, la cosa se complica. Puedes renombrar la carpeta /modules a /modules_bak vía FTP. Esto desactivará todos los módulos de golpe (la tienda puede dar error, pero es temporal). Si la página vuelve a cargar (aunque sea sin estilos), el problema era un módulo. Luego, mueve los módulos de vuelta uno a uno o en lotes pequeños para encontrar al culpable.

Soluciones específicas para el error 503 PrestaShop

El error 503 es más de "estado" que de "código". Aquí las soluciones son más directas.

1. Desactivar el modo mantenimiento desde la base de datos

Si el modo mantenimiento se quedó atascado, hay que desactivarlo manualmente.

Accede a tu base de datos MySQL (vía phpMyAdmin, por ejemplo).
Busca la tabla ps_configuration (el prefijo ps_ puede variar).
Busca la fila donde name sea PS_SHOP_ENABLE.
Cambia el value de 0 a 1.
Guarda los cambios.

2. Comprobar el estado de PHP-FPM (si tienes un VPS)

Si gestionas tu propio servidor y usas Syspanel (accediendo por el puerto 2106), el servicio PHP-FPM puede estar caído.

Abre el panel de Syspanel.
Ve a la sección de "Servicios" o "Estado del servidor".
Busca php-fpm o phpXX-fpm (donde XX es la versión, ej: php82-fpm).
Si está parado, haz clic en "Reiniciar" o "Iniciar".

[WARNING]: Si no sabes qué es PHP-FPM, no toques nada más en el panel. Reiniciar servicios del sistema puede causar más problemas si no se hace correctamente.

3. Limpiar la caché de PrestaShop

A veces una caché corrupta da errores extraños.

Vía FTP, elimina el contenido de las carpetas /var/cache y /var/cache/prod. No borres las carpetas, solo su contenido.
También puedes borrar el contenido de la carpeta /cache si tu versión de PrestaShop la usa.

Soluciones para la página en blanco

Este es el más delicado. Como no hay mensaje, hay que investigar a ciegas.

1. El truco del archivo `config/defines.inc.php` (ya explicado)

Es la única forma de obtener información. Si no has activado el debug, hazlo ahora. Sin un mensaje de error, estamos perdidos.

2. Comprobar el archivo `settings.inc.php`

Este archivo contiene la configuración de la base de datos. Asegúrate de que las líneas define('_DB_SERVER_', 'localhost');, define('_DB_NAME_', 'tu_base');, define('_DB_USER_', 'tu_usuario'); y define('_DB_PASSWD_', 'tu_password'); son correctas. Un cambio en la contraseña de la base de datos (por ejemplo, al migrar de hosting) rompe la tienda sin dar error.

3. Revisar el final de los archivos PHP

Un error muy común es que un archivo tenga una línea en blanco o un espacio después de la etiqueta de cierre de PHP (?>). Esto envía caracteres al navegador antes de que la tienda cargue, causando la página en blanco.

Revisa los archivos que hayas editado recientemente.
Si encuentras la etiqueta ?> al final, puedes borrarla. Es una buena práctica no cerrar los archivos PHP con ?>.

Preguntas Frecuentes (FAQ) sobre errores PrestaShop

Aquí respondemos a las dudas más comunes que nos llegan al soporte.

¿Por qué recibo un error 500 después de actualizar un módulo?

Es muy común. La actualización del módulo puede ser incompatible con tu versión de PrestaShop o con otro módulo. Prueba a desactivar el módulo que acabas de actualizar siguiendo los pasos de la sección 4 del error 500.

¿Puedo perder mis productos o pedidos con estos errores?

No. Los errores 500, 503 y la página en blanco son errores de "presentación" o de "procesamiento". Tu base de datos, donde están los productos, clientes y pedidos, no se ve afectada. El riesgo de pérdida de datos es mínimo, pero siempre es recomendable tener una copia de seguridad actualizada.

¿Cómo puedo prevenir estos errores en el futuro?

La prevención es la mejor medicina. Sigue estos consejos:

Mantén PrestaShop y los módulos actualizados.
Haz copias de seguridad periódicas de archivos y base de datos.
No instales módulos de fuentes no oficiales.
Aumenta el límite de memoria PHP de forma preventiva a 256M o 512M.
Contrata un hosting de calidad que se ajuste a los requisitos de PrestaShop.

¿Qué hago si nada de esto funciona?

Si has agotado todos estos pasos y el error prestashop persiste, es hora de pedir ayuda profesional. Contacta con tu proveedor de hosting (es posible que haya un problema en su servidor, como un disco lleno o un fallo de hardware) o contrata a un desarrollador especializado en PrestaShop.

Conclusión: Mantén la calma y actúa con método

Como has visto, solucionar prestashop no es magia, es método. Los errores 500, 503 y la página en blanco son aterradores, pero en el 90% de los casos se resuelven con una de estas soluciones: regenerar el .htaccess, corregir permisos, aumentar la memoria o desactivar un módulo conflictivo.

[TIP]: Antes de tocar nada, haz una copia de seguridad de tu sitio. Te dará tranquilidad y podrás revertir cualquier cambio si algo sale mal.

Esperamos que esta guía te haya sido de gran ayuda. Si tienes alguna duda sobre tu configuración específica, no dudes en dejar un comentario o contactar con tu soporte técnico. ¡Tu tienda volverá a estar operativa en un abrir y cerrar de ojos!