Errores Comunes PrestaShop | Solucionar 500, 503 y más

¿Por qué aparecen los errores 500 y 503 en PrestaShop?

Los errores en PrestaShop son más comunes de lo que parece, y la buena noticia es que la mayoría tienen solución sin necesidad de ser un experto en programación. Cuando tu tienda muestra un error 500 o un error 503, significa que el servidor está teniendo problemas para procesar la solicitud, pero la causa puede variar desde un simple archivo con permisos incorrectos hasta un módulo incompatible.

Antes de entrar en pánico, respira. Estos errores prestashop son diagnósticos, no sentencias. Te voy a explicar paso a paso cómo identificar la causa y solucionarla, incluso si nunca has tocado un archivo de configuración en tu vida.

¿Qué significa cada error?

PrestaShop error 500: Error interno del servidor

El prestashop error 500 es el más genérico y frustrante. Significa que algo falló en el servidor, pero no te dice exactamente qué. Las causas más frecuentes son:

Archivos con permisos incorrectos (generalmente después de una migración o actualización).
Un módulo o tema que genera un conflicto con PHP.
Falta de memoria PHP asignada.
Archivos .htaccess corruptos o mal configurados.
Problemas con la versión de PHP incompatible con tu PrestaShop.

PrestaShop error 503: Servicio no disponible

El prestashop error 503 es diferente: el servidor está funcionando, pero no puede completar la petición. Es típico cuando:

La tienda está en modo mantenimiento y el archivo de bloqueo no se eliminó correctamente.
El servidor está sobrecargado por demasiadas solicitudes.
Hay un problema con el archivo settings.inc.php que impide la conexión con la base de datos.
Un plugin de caché está generando un bucle infinito.

Primeros pasos: antes de tocar nada

1. Activa el modo debug de PrestaShop

La forma más rápida de solucionar problemas prestashop es activar el modo de depuración. Esto te mostrará el error real en pantalla en lugar de la página genérica.

Accede a tu servidor por FTP o desde el panel de control de tu hosting y busca el archivo config/defines.inc.php. Dentro, localiza esta línea:

define('_PS_MODE_DEV_', false);

Cámbiala a:

define('_PS_MODE_DEV_', true);

Guarda el archivo y recarga tu tienda. Ahora verás el mensaje de error específico, como "Fatal error: Allowed memory size exhausted" o "Class not found". Ese mensaje te dirá exactamente por dónde empezar.

[WARNING] No olvides volver a poner false cuando termines de solucionar el problema. Dejar el modo debug activo en producción expone información sensible de tu servidor.

2. Revisa los logs del servidor

Si el modo debug no te da suficiente información, revisa los registros de error. En la mayoría de los paneles de control (cPanel, Plesk, Syspanel) encontrarás una sección de "Registros de errores" o "Error Logs".

Si tu hosting usa Syspanel, recuerda que el acceso es a través del puerto 2106 (ejemplo: https://tu-dominio.com:2106). Allí podrás ver los logs de Apache o Nginx en tiempo real.

Soluciones específicas para el error 500

3. Permisos de archivos y carpetas

Los permisos incorrectos son la causa número uno del prestashop error 500. Después de una migración o restauración, es común que los archivos queden con permisos demasiado restrictivos.

Conéctate por FTP y asegúrate de que:

Las carpetas tengan permisos 755.
Los archivos tengan permisos 644.
La carpeta cache y log tengan permisos 777 (aunque en algunos servidores basta con 755).

Si usas un cliente FTP como FileZilla, selecciona todos los archivos y carpetas, haz clic derecho y elige "Permisos de archivo". Aplica los valores mencionados de forma recursiva.

[TIP] Si después de cambiar permisos el error persiste, verifica que el archivo .htaccess no esté vacío o corrupto. Puedes regenerarlo desde el back office: Parámetros avanzados > Rendimiento > "Regenerar el archivo .htaccess".

4. Aumenta el límite de memoria PHP

Muchas veces el error 500 aparece porque PHP se queda sin memoria. Esto es especialmente común en tiendas con muchos productos o módulos pesados.

Localiza el archivo php.ini en la raíz de tu hosting. Si no existe, créalo con el siguiente contenido:

memory_limit = 256M
max_execution_time = 120
max_input_vars = 5000

Guarda y sube el archivo. Si tu hosting no te permite usar php.ini, puedes añadir estas líneas al archivo .htaccess:

php_value memory_limit 256M
php_value max_execution_time 120

5. Desactiva módulos problemáticos

¿El error apareció después de instalar un módulo nuevo? Entonces casi seguro que es un conflicto.

Accede a tu servidor por FTP y renombra la carpeta del módulo sospechoso en /modules/. Por ejemplo, si crees que el problema es con el módulo de pagos, renombra /modules/paypal/ a /modules/paypal_backup/.

Recarga tu tienda. Si el error desaparece, ya sabes quién era el culpable. Puedes intentar actualizar el módulo o contactar con su desarrollador.

6. Verifica la versión de PHP

PrestaShop 1.7 y versiones anteriores no son compatibles con PHP 8.0 o superior. Si tu hosting actualizó PHP automáticamente, es muy probable que tengas el error.

Desde el panel de control de tu hosting, cambia la versión de PHP a 7.4 o 7.3. En Syspanel, ve a "Administrador de PHP" y selecciona la versión adecuada.

[INFO] PrestaShop 8.x soporta PHP 8.1, pero si tienes una versión anterior, quédate en PHP 7.4 para evitar incompatibilidades con módulos antiguos.

Soluciones específicas para el error 503

7. Elimina el modo mantenimiento atascado

A veces, cuando activas el modo mantenimiento y no lo desactivas correctamente, PrestaShop deja un archivo de bloqueo que provoca el prestashop error 503.

Conéctate por FTP y busca en la raíz de tu instalación un archivo llamado maintenance.flag o maintenance.php. Si existe, elimínalo.

También verifica en la base de datos: en la tabla ps_configuration, busca la variable PS_SHOP_ENABLE y asegúrate de que tenga el valor 1. Si tiene 0, cámbialo a 1.

8. Reconstruye el archivo .htaccess

Un .htaccess dañado puede generar tanto errores 500 como 503. Para reconstruirlo:

Conéctate por FTP y descarga el archivo .htaccess actual.
Renómbralo a .htaccess_backup (no lo elimines por seguridad).
Accede a tu back office. Si no puedes, crea un archivo .htaccess nuevo con este contenido básico:

# Use PHP 7.4
AddHandler application/x-httpd-php74 .php
<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteBase /
</IfModule>

Luego entra al back office y ve a Parámetros avanzados > Rendimiento. Pulsa el botón "Regenerar el archivo .htaccess".

9. Comprueba la conexión con la base de datos

El error 503 también aparece cuando PrestaShop no puede conectar con MySQL. Esto suele pasar después de cambiar la contraseña de la base de datos o mover el servidor.

Revisa el archivo config/settings.inc.php (en PrestaShop 1.6) o app/config/parameters.php (en PrestaShop 1.7+). Verifica que el usuario, contraseña y nombre de la base de datos sean correctos.

[WARNING] Si modificas estos archivos, asegúrate de no dejar espacios en blanco antes de <?php, ya que eso también genera errores.

Mantenimiento preventivo: evita futuros errores

10. Actualiza todo regularmente

La mayoría de los errores prestashop se deben a versiones desactualizadas. Mantén actualizado:

El núcleo de PrestaShop.
Los módulos (elimina los que no uses).
El tema de tu tienda.
La versión de PHP (sin pasarte a versiones incompatibles).

11. Haz copias de seguridad periódicas

Antes de hacer cualquier cambio, realiza una copia de seguridad completa de archivos y base de datos. Si algo sale mal, podrás restaurar en minutos.

En Syspanel, puedes crear copias de seguridad automáticas desde la sección "Copias de seguridad" indicando que el puerto de acceso es el 2106.

12. Monitorea el rendimiento

Instala un módulo de monitorización o usa herramientas como Google PageSpeed Insights. Un servidor lento o sobrecargado es el caldo de cultivo perfecto para errores 503.

Preguntas frecuentes (FAQ)

¿El error 500 puede deberse a un problema de mi hosting?

Sí, es posible. Si tu servidor tiene problemas de recursos (CPU, memoria RAM) o configuraciones restrictivas, puede generar errores. Contacta con tu proveedor de hosting y comparte los logs para que te ayuden.

¿Pierdo mis datos si elimino el archivo .htaccess?

No, el .htaccess solo contiene reglas de reescritura y configuración del servidor. Tus productos, pedidos y clientes están en la base de datos, así que no pierdes nada. Eso sí, guarda una copia antes de modificarlo.

¿Cómo sé si el problema es un módulo o el tema?

Activa el modo debug y observa el mensaje de error. Si menciona una clase o archivo de un módulo específico, ese es el problema. Si menciona el tema, desactívalo temporalmente cambiando a un tema predeterminado como "classic".

¿Qué hago si nada de esto funciona?

Si has probado todos los pasos y el error persiste, contacta con tu proveedor de hosting. A veces el problema está en el servidor (por ejemplo, un firewall demasiado estricto o una configuración de mod_security que bloquea peticiones legítimas).

Resumen final

Los errores prestashop como el 500 y el 503 no tienen por qué ser una pesadilla. Con un enfoque metódico y las herramientas adecuadas, la mayoría de problemas se resuelven en menos de una hora:

Activa el modo debug para ver el error real.
Revisa los logs del servidor.
Corrige permisos de archivos.
Ajusta la memoria PHP.
Desactiva módulos conflictivos.
Verifica la versión de PHP.
Elimina archivos de mantenimiento atascados.
Regenera el .htaccess.
Comprueba la conexión con la base de datos.

Y recuerda: siempre trabaja con una copia de seguridad reciente. Así, aunque algo salga mal, podrás restaurar tu tienda en cuestión de minutos sin perder ventas ni datos importantes.

Si tu hosting utiliza Syspanel, accede por el puerto 2106 para gestionar todo lo mencionado: logs, versiones de PHP, copias de seguridad y más. Es una herramienta potente que te facilitará la vida cuando necesites solucionar problemas prestashop.

Espero que esta guía te haya sido útil. Si tienes alguna duda, déjala en los comentarios y estaré encantado de ayudarte. ¡Tu tienda volverá a estar operativa en poco tiempo!