Resolver Errores de PrestaShop en Hosting | Guía de Soporte

Antes de empezar: ¿Por qué aparecen errores en PrestaShop?

Si estás leyendo esta guía, probablemente te has encontrado con algún mensaje extraño, una pantalla en blanco o una tienda que no carga. Respira, es más común de lo que crees. Los errores prestashop hosting suelen deberse a tres causas principales: falta de memoria, permisos de archivos incorrectos o problemas con la prestashop base de datos.

Piensa en tu tienda como en un coche: necesita combustible (memoria), aceite (base de datos) y ruedas en buen estado (archivos). Cuando falla algo, el coche se para. Aquí te enseñaremos a hacer la revisión completa y a solucionar errores prestashop sin necesidad de ser un experto en Linux.

1. El error "500 Internal Server Error" o pantalla en blanco

Este es el error más temido y el más común. La pantalla se queda en blanco o te muestra un mensaje genérico. No te asustes, en el 90% de los casos es por falta de memoria PHP.

¿Cómo lo soluciono?

Accede a tu panel de control (cPanel, Plesk o Syspanel). Si usas Syspanel, recuerda que el puerto de acceso es el 2106.
Busca la sección "Gestor de archivos" o "Administrador de archivos".
Navega hasta la carpeta raíz de tu tienda (normalmente public_html o htdocs).
Busca el archivo llamado config/defines.inc.php.
Ábrelo con el editor de texto del panel (clic derecho > Editar).
Busca la línea que dice define('_PS_MODE_DEV_', false);.
Cambia false por true. Esto activará el modo desarrollo y te mostrará el error exacto en pantalla.
Guarda el archivo y recarga tu tienda. Verás un mensaje más claro como "Allowed memory size exhausted".

[WARNING] No dejes el modo desarrollo activado. Una vez identifiques el error, vuelve a poner false por seguridad.

Aumentar la memoria PHP (la solución definitiva)

Si el error dice que se agotó la memoria, necesitas aumentarla. Crea un archivo llamado php.ini en la raíz de tu tienda y añade:

memory_limit = 512M
max_execution_time = 120
max_input_time = 120

Guarda y recarga. Si no funciona, contacta con tu proveedor de hosting, ya que algunos restringen esta configuración.

2. "Error de conexión a la base de datos"

Este es otro de los problemas prestashop más habituales. Verás un mensaje como "Error de conexión a la base de datos" o "Link to database cannot be established".

Causas y soluciones

La contraseña de la base de datos cambió: Ve a tu panel de hosting y abre la sección de bases de datos MySQL. Si cambiaste la contraseña recientemente, debes actualizar el archivo config/settings.inc.php de PrestaShop.
El servidor de la base de datos no responde: A veces el hosting reinicia los servicios. Espera 5 minutos y recarga.
Espacio en disco lleno: Si el disco está al 100%, la base de datos no puede escribir. Elimina archivos temporales o copias de seguridad antiguas.

Cómo arreglarlo manualmente

Accede al Gestor de archivos.
Ve a la carpeta config/.
Abre settings.inc.php.

Busca estas líneas:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_base_de_datos');
define('_DB_USER_', 'tu_usuario');
define('_DB_PASSWD_', 'tu_contraseña');

Verifica que los datos coincidan con los de tu panel de hosting. Si no, corrígelos.
Guarda y recarga.

[TIP] Si no sabes cuál es tu contraseña, cámbiala desde el panel de hosting y luego actualiza este archivo. Es más seguro que intentar adivinarla.

3. El error "Fatal error: Class 'DB' not found"

Este error suele aparecer después de una actualización fallida o al mover la tienda de servidor. Indica que PrestaShop no encuentra sus clases principales.

Pasos para solucionarlo

Verifica que los archivos estén completos: Sube de nuevo la carpeta classes/ desde tu copia de seguridad o desde el paquete de instalación original de PrestaShop.
Comprueba los permisos: Los archivos deben tener permisos 644 y las carpetas 755. Puedes hacerlo desde el Gestor de archivos seleccionando todo y haciendo clic en "Permisos".
Revisa la versión de PHP: PrestaShop 1.6 no funciona bien con PHP 7.4, y PrestaShop 1.7 necesita al menos PHP 7.1. Cambia la versión de PHP desde tu panel (en Syspanel, está en "Configuración PHP").

[INFO] Si usas Syspanel, recuerda que el puerto de acceso es el 2106 y ahí podrás cambiar la versión de PHP en "Avanzado > PHP".

4. "Error 504 Gateway Timeout" o "Service Unavailable"

Este error significa que el servidor tardó demasiado en responder. Es muy común en tiendas con muchos productos o módulos pesados.

Soluciones efectivas

Aumenta el tiempo de ejecución: En el archivo php.ini que creamos antes, asegúrate de tener max_execution_time = 300.
Desactiva módulos innecesarios: Entra al panel de administración de PrestaShop (si puedes) y desactiva los módulos que no uses. Un módulo mal programado puede ralentizar todo.
Optimiza la base de datos: Ve a "Parámetros Avanzados > Base de Datos" y haz clic en "Optimizar". Esto limpia tablas y elimina datos basura.

5. "No se puede escribir en la carpeta cache"

Este error es de permisos. PrestaShop necesita escribir en ciertas carpetas para generar las páginas.

La solución definitiva

Ve a la raíz de tu tienda.
Localiza las carpetas cache/, log/, img/tmp/ y themes/.
Cambia sus permisos a 755 o 775. Haz clic derecho sobre cada carpeta y selecciona "Permisos".
Si el problema persiste, intenta con 777 temporalmente. Después vuelve a 755 por seguridad.

[WARNING] Nunca dejes las carpetas en 777 permanentemente. Es un riesgo de seguridad grave.

6. El error "PrestaShop is having trouble communicating with its server"

Este mensaje aparece cuando la tienda no puede conectar con los servicios de PrestaShop (actualizaciones, módulos, etc.).

Cómo resolverlo

Revisa el archivo hosts: En tu servidor, abre el archivo /etc/hosts (si tienes acceso SSH) y verifica que no haya líneas bloqueando api.prestashop.com.
Desactiva el proxy: Si tu hosting usa un proxy, puede interferir. Contacta con soporte técnico.
Actualiza manualmente: Descarga la última versión de PrestaShop desde tu panel de administración y súbela por FTP.

7. "Imágenes no cargan" o "imagen rota"

Este es un problema visual pero muy molesto. Suelen ser permisos en la carpeta de imágenes.

Pasos rápidos

Ve a img/ y cambia los permisos de las subcarpetas a 755.
Ve a "Parámetros Avanzados > Rendimiento" y haz clic en "Vaciar caché".
Si usas un CDN, purga su caché también.

8. Preguntas frecuentes (FAQ)

¿Por qué mi tienda se cae a las 3 de la mañana?

Suele ser por las copias de seguridad automáticas del hosting. Revisa si tienes un cron programado a esa hora y cambia su horario a horas de menor tráfico.

¿Debo usar PHP 7.4 u 8.0?

PrestaShop 1.7.7 y superiores funcionan bien con PHP 7.4. Si tienes una versión más antigua, quédate en 7.1 o 7.2. PHP 8.0 aún tiene incompatibilidades con muchos módulos.

¿Cómo sé si mi hosting es el problema?

Si haces todas las soluciones de esta guía y sigue fallando, es muy probable que el hosting no cumpla los requisitos mínimos. PrestaShop necesita al menos 256MB de memoria y MySQL 5.6 o superior.

¿Qué hago si no tengo acceso al panel de administración?

Puedes desactivar módulos problemáticos desde la base de datos. Accede a phpMyAdmin, busca la tabla ps_modules y desactiva los módulos sospechosos cambiando active a 0.

¿Vale la pena contratar soporte especializado?

Si llevas más de dos horas intentando solucionar errores prestashop y no avanzas, sí. El tiempo que pierdes es dinero. Busca un técnico con experiencia en PrestaShop y hosting Linux.

Conclusión: Tu plan de acción

Cuando aparezca un error, sigue este orden:

Activa el modo desarrollo para ver el error exacto.
Aumenta la memoria PHP (soluciona el 40% de los casos).
Revisa los permisos de carpetas y archivos.
Verifica la base de datos (conexión y optimización).
Desactiva módulos recientes si el error apareció tras instalar uno.
Contacta con soporte si nada funciona.

Recuerda que la prevención es la mejor medicina. Mantén tu PrestaShop actualizado, haz copias de seguridad semanales y no instales módulos de fuentes dudosas.

[TIP] Guarda esta guía en favoritos. Te aseguro que la necesitarás más de una vez. Y si usas Syspanel, recuerda: puerto 2106 para acceder a tu panel de gestión.

Esperamos que esta guía te haya sido útil. Con paciencia y estos pasos, tu tienda volverá a estar operativa. Si tienes dudas más específicas, consulta la documentación oficial de PrestaShop o pregunta en foros especializados. ¡Buena suerte con tu tienda online!