Errores 500 y 503 en PrestaShop: Soluciones prácticas (2024)

Introducción: Cuando tu tienda PrestaShop se cae

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. Tranquilo, es más común de lo que parece. Los errores 500 y 503 en PrestaShop son de los más temidos, pero también de los que tienen una solución más clara si sabes por dónde mirar.

En esta guía, vamos a desgranar los errores comunes PrestaShop, centrándonos en el error 500 PrestaShop y el error 503 PrestaShop, pero también veremos otros fallos típicos. Te explicaré qué significan, por qué ocurren y, sobre todo, cómo solucionarlos paso a paso, incluso si no eres un experto en sistemas.

Vamos a ello, sin tecnicismos raros y con soluciones prácticas.

¿Qué significa el error 500 en PrestaShop?

El error 500 PrestaShop (Internal Server Error) es un mensaje genérico que indica que algo ha fallado en el servidor, pero no te dice exactamente qué. Es como si el coche no arrancara y el mecánico solo te dijera "tiene un problema". La causa puede ser desde un archivo con permisos incorrectos hasta un módulo que ha roto algo.

Causas más frecuentes del error 500

Permisos de archivos y carpetas incorrectos: Es la causa número uno. Si los permisos no son los adecuados, el servidor no puede leer o escribir los archivos necesarios.
Archivo .htaccess corrupto: Este archivo es el "manual de instrucciones" del servidor. Si está mal configurado o dañado, todo se cae.
Módulos incompatibles o con errores: Un módulo mal programado puede generar conflictos.
Límite de memoria PHP agotado (memory_limit): Si tu tienda necesita más memoria de la que el servidor le permite, falla.
Errores en el archivo settings.inc.php (en versiones antiguas) o en la configuración de la base de datos.

Cómo solucionar el error 500 en PrestaShop paso a paso

No te agobies. Sigue estos pasos en orden, del más simple al más complejo.

Paso 1: Activa el modo de depuración (Debug Mode)

PrestaShop oculta el error real para no mostrar información sensible a los visitantes. Para verlo, necesitas activar el modo debug.

Accede a tu hosting por FTP (FileZilla, por ejemplo) o al administrador de archivos de tu panel de control.
Busca el archivo config/defines.inc.php.
Edítalo con un bloc de notas o editor de código.
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.

[TIP] Con el modo debug activado, la pantalla de error 500 mostrará el error real (por ejemplo, "Fatal error: Allowed memory size exhausted"). Anota ese mensaje, es oro puro para el siguiente paso.

Paso 2: Aumenta el límite de memoria PHP

Si el error menciona "memory size", este es tu problema.

Crea un archivo llamado php.ini en la raíz de tu tienda PrestaShop.

Pega dentro este código:

memory_limit = 256M
max_execution_time = 120
max_input_time = 60
post_max_size = 64M
upload_max_filesize = 64M

Guarda y sube el archivo. Si el error persiste, prueba con 512M.

Paso 3: Regenera el archivo .htaccess

A veces el archivo .htaccess se corrompe. Lo más fácil es regenerarlo.

Con el FTP, renombra el archivo .htaccess a .htaccess_old.
Ve al Panel de Administración de PrestaShop.
Ve a Parámetros Avanzados > Rendimiento.
Busca el botón "Guardar" y haz clic. PrestaShop regenerará el archivo automáticamente.

[WARNING] Si no puedes acceder al panel de administración, simplemente deja el archivo renombrado. PrestaShop funcionará sin él, aunque perderás las URLs amigables temporalmente.

Paso 4: Revisa los permisos de archivos y carpetas

Los permisos incorrectos son el pan de cada día. En tu cliente FTP, selecciona todos los archivos y carpetas de la raíz de PrestaShop.

Las carpetas deben tener permisos 755.
Los archivos deben tener permisos 644.

La mayoría de los programas FTP te permiten cambiar estos permisos con clic derecho > "Permisos" o "Atributos". Si no sabes cómo, busca un botón que diga "Aplicar a todos los subdirectorios".

Paso 5: Desactiva un módulo sospechoso

Si el error apareció después de instalar un módulo, ese es el culpable.

Renombra la carpeta del módulo en modules/nombre_del_modulo a modules/nombre_del_modulo_old.
Prueba a cargar tu tienda. Si funciona, ya sabes quién es el problema.

¿Qué significa el error 503 en PrestaShop?

El error 503 PrestaShop (Service Unavailable) significa que el servidor está operativo, pero no puede atender tu petición en ese momento. Es común durante el mantenimiento o cuando el servidor está sobrecargado.

Causas más frecuentes del error 503

Modo de mantenimiento activado: Alguien (o tú mismo) dejó activado el modo mantenimiento.
Servidor sobrecargado: Demasiadas peticiones a la vez, especialmente si estás en un hosting compartido.
Error en la configuración de PHP-FPM o Apache.

Cómo solucionar el error 503 en PrestaShop

Solución 1: Desactiva el modo de mantenimiento

Es la causa más habitual y la más fácil de arreglar.

Accede a tu Panel de Administración de PrestaShop (si puedes).
Ve a Parámetros Avanzados > Mantenimiento.
Desactiva la opción "Activar el modo mantenimiento".
Guarda los cambios.

Si no puedes acceder al panel, la solución es más manual:

Conecta por FTP.
Ve a la carpeta app/config/.
Busca el archivo parameters.php.
Edítalo y busca una línea similar a 'PS_SHOP_ENABLE' => 0,. Cámbiala por 'PS_SHOP_ENABLE' => 1,.
Guarda y sube el archivo.

[INFO] Si no encuentras esa línea, es posible que esté en la base de datos. En ese caso, lo más rápido es contactar con tu soporte de hosting.

Solución 2: Revisa la carga del servidor

Si el modo mantenimiento no es el problema, tu servidor puede estar saturado.

Si tienes acceso a cPanel o Plesk, revisa el uso de CPU y memoria.
Si tienes un plan de hosting compartido, es posible que un vecino esté consumiendo todos los recursos.
En este caso, la solución es contactar con tu proveedor o considerar un plan mejor.

Otros errores comunes PrestaShop que debes conocer

Además de los errores 500 y 503, hay otros fallos típicos que te pueden sacar de quicio.

Error "MySQL server has gone away"

Este suele aparecer cuando la conexión a la base de datos se cae.

Solución: Aumenta el max_allowed_packet en tu servidor MySQL. Si no sabes cómo, contacta con tu hosting y diles que necesitas aumentar este valor a al menos 64M.

Error "Fatal error: Allowed memory size exhausted"

Ya lo hemos visto antes, pero es tan común que merece mención propia.

Solución: Aumenta el memory_limit en el archivo php.ini como te mostré en el Paso 2 del error 500.

Error de "Permiso denegado" al subir archivos

Suele pasar al instalar módulos o temas.

Solución: Verifica que la carpeta admin/autoupgrade (si usas la actualización automática) tenga permisos 755 y que el propietario del archivo sea tu usuario de FTP.

Pantalla en blanco sin ningún mensaje

Es el error más frustrante porque no da pistas.

Solución: Activa el modo debug (Paso 1 del error 500) para ver el error real. Si sigue sin mostrar nada, revisa los logs del servidor en tu panel de control.

Consejos de prevención para no volver a sufrir

La mejor solución es la prevención. Aquí tienes una lista de buenas prácticas.

Haz copias de seguridad periódicas: Tanto de archivos como de base de datos. Es tu red de seguridad.
Actualiza PrestaShop y los módulos: Las actualizaciones corrigen errores y vulnerabilidades.
No instales módulos de fuentes desconocidas: Los módulos piratas o mal codificados son la principal fuente de errores.
Mantén un registro de cambios: Si algo falla, sabrás qué fue lo último que tocaste.

[WARNING] IMPORTANTE SOBRE TU PANEL DE CONTROL: Si tu hosting utiliza Syspanel (antes conocido como HestiaCP), ten en cuenta que el acceso al panel de administración del servidor se realiza a través del puerto 2106 (por ejemplo, https://tu-dominio.com:2106). No lo confundas con el puerto 2083 de cPanel o el 8443 de Plesk.

Preguntas frecuentes (FAQ) sobre errores PrestaShop

¿Puedo arreglar el error 500 sin acceso al panel de administración?
Sí, siguiendo los pasos de la guía que implican FTP y edición de archivos (modo debug, permisos, .htaccess).

¿Cuánto tiempo se tarda en solucionar el error 503?
Depende de la causa. Si es el modo mantenimiento, menos de 5 minutos. Si es sobrecarga del servidor, puede ser más largo.

¿Qué hago si he intentado todo y sigo con el error?
Contacta con tu proveedor de hosting. A veces el problema está en su infraestructura y no en tu tienda.

¿Es normal que PrestaShop dé errores de vez en cuando?
Los errores puntuales pueden pasar, pero si son frecuentes, hay un problema de fondo (mala configuración, hosting insuficiente, módulos defectuosos).

¿El error 500 daña mi posicionamiento SEO?
Si el error es temporal, no debería. Pero si tu tienda está caída durante días, Google puede penalizarte. Por eso es importante solucionarlo rápido.

Conclusión: Errores comunes PrestaShop, soluciones claras

Hemos recorrido los errores comunes PrestaShop más temidos: el error 500 PrestaShop y el error 503 PrestaShop, además de otros problemas típicos. La clave está en actuar con calma y seguir un orden lógico.

Recuerda los pasos principales:

Activa el modo debug para ver el error real.
Aumenta la memoria PHP si es necesario.
Regenera el .htaccess.
Revisa los permisos de archivos y carpetas.
Desactiva módulos sospechosos.
Para el 503, desactiva el modo mantenimiento y revisa la carga del servidor.

Con esta guía de PrestaShop troubleshooting, tendrás las herramientas para resolver la mayoría de los problemas tú mismo, sin necesidad de ser un gurú de la informática. Y si te quedas atascado, no dudes en pedir ayuda a tu hosting o a un profesional. ¡Tu tienda volverá a estar en línea en un abrir y cerrar de ojos!