Problemas de conexión en PrestaShop con Syspanel: soluciones

¿Tu tienda PrestaShop de repente no carga, da errores de conexión a la base de datos o muestra pantallas en blanco? Es frustrante, sobre todo si tienes clientes intentando comprar. No te preocupes, estás en el lugar correcto. Esta guía está diseñada para que, paso a paso, puedas diagnosticar y solucionar los problemas conexión PrestaShop más comunes, especialmente cuando tu tienda está alojada en un servidor gestionado a través de Syspanel (nuestro panel de control basado en HestiaCP, al que accedes por el puerto 2106).

Vamos a desglosar desde lo más básico (¿está encendido el servidor?) hasta ajustes más técnicos (como la configuración de parámetros en PrestaShop). El objetivo es que puedas recuperar tu tienda online lo antes posible.

1. Lo Primero: Diagnóstico Rápido desde Syspanel

Antes de tocar archivos o bases de datos, verifica el estado general de tu alojamiento desde Syspanel. Piensa en esto como el "panel de mandos" de tu tienda.

1.1. Accede a tu panel Syspanel

Abre tu navegador y escribe la dirección de tu servidor seguida del puerto :2106. Por ejemplo: https://tudominio.com:2106 o la IP que te hayamos proporcionado. Inicia sesión con tus credenciales.

1.2. Revisa el estado de los servicios

Dentro de Syspanel, busca la sección de "Servicios" o "Estado del servidor". Deberías ver una lista de servicios como Apache (o Nginx), MySQL / MariaDB y PHP. Asegúrate de que todos tengan un punto verde o indiquen "Running".

[WARNING] Si ves algún servicio en rojo o con estado "Stopped", no entres en pánico. Simplemente haz clic en el botón de "Reiniciar" o "Start" junto a ese servicio. A menudo, un simple reinicio de MySQL o Apache soluciona el Syspanel PrestaShop error de conexión.

1.3. Verifica el uso de recursos

En la pantalla principal de Syspanel (o en la sección "Estadísticas"), mira el uso de CPU, RAM y Disco. Si alguno está al 100%, tu servidor está saturado. Esto puede provocar que PrestaShop no responda.

[INFO] Si el disco está lleno, tu tienda no podrá escribir archivos de caché, logs o incluso nuevos pedidos. En ese caso, necesitarás liberar espacio (por ejemplo, eliminando copias de seguridad antiguas o logs de acceso).

2. El Error Clásico: "Error de conexión a la base de datos"

Este es, con diferencia, el problemas conexión PrestaShop más habitual. La pantalla blanca con "Link to database cannot be established" o "Error de conexión a la base de datos" suele deberse a:

2.1. Credenciales incorrectas en el archivo de configuración

PrestaShop guarda los datos de acceso a la base de datos en un archivo llamado app/config/parameters.php (en PrestaShop 1.7 y 8.x) o config/settings.inc.php (en PrestaShop 1.6).

Para solucionarlo:

Conéctate a tu servidor mediante Syspanel > Administrador de archivos (o vía FTP/SFTP).
Navega a la carpeta raíz de tu tienda (la que contiene las carpetas admin, modules, themes, etc.).
Abre el archivo app/config/parameters.php.

Busca estas líneas:

'database_host' => 'localhost',
'database_name' => 'nombre_de_tu_bd',
'database_user' => 'usuario_de_tu_bd',
'database_password' => 'contraseña_de_tu_bd',

Compara estos datos con los que tienes en Syspanel. En Syspanel, ve a Base de Datos y allí verás el nombre, usuario y contraseña de tu base de datos. Si no coinciden, cámbialos en el archivo.

[TIP] Si has cambiado la contraseña de la base de datos desde Syspanel, debes actualizarla también en este archivo. Es un error muy común.

2.2. El host de la base de datos no es 'localhost'

A veces, por cuestiones de seguridad o configuración del servidor, la base de datos no está en el mismo servidor web o se accede mediante un socket. Si tu servidor usa una IP o un nombre de host diferente, cámbialo en el campo database_host. En Syspanel, suele ser localhost o 127.0.0.1, pero si no funciona, prueba con la IP del servidor.

2.3. La base de datos ha alcanzado su límite de conexiones

Si tu tienda tiene mucho tráfico, es posible que la base de datos esté saturada de conexiones. Desde Syspanel no siempre puedes ver esto directamente, pero puedes intentar:

Reiniciar el servicio MySQL desde Syspanel (sección Servicios). Esto libera todas las conexiones.
Optimizar las tablas desde phpMyAdmin (accesible desde Syspanel > Base de Datos > phpMyAdmin). Selecciona todas las tablas y elige "Optimizar tabla".

3. Problemas de Caché y Rendimiento

A veces, el problema no es de conexión, sino de que PrestaShop está "atascado" con una caché corrupta.

3.1. Limpiar la caché desde el Back Office (si puedes acceder)

Si tienes acceso al panel de administración de PrestaShop, ve a Parámetros Avanzados > Rendimiento y haz clic en "Limpiar caché".

3.2. Limpiar la caché manualmente (si no puedes acceder)

Si el Back Office no carga, hazlo manualmente:

Desde Syspanel, ve al Administrador de archivos.
Elimina todo el contenido de la carpeta var/cache/ (o cache/ en PrestaShop 1.6). No borres la carpeta en sí, solo su interior.
También puedes eliminar la carpeta cache/smarty/compile y cache/smarty/cache.

[WARNING] Al limpiar la caché manualmente, la tienda puede cargar un poco más lento en la primera visita, pero se regenerará automáticamente.

3.3. Deshabilitar la caché de MySQL

En el archivo app/config/parameters.php, busca la línea 'cache' => 'CacheMemcache' o similar. Si la ves, coméntala (ponle // delante) o cambia su valor a 'CacheApc' o simplemente bórrala. A veces, un tipo de caché mal configurado da errores de conexión.

4. Errores Relacionados con el Tema o Módulos

Un tema o módulo mal programado puede romper la conexión o causar un error fatal de PHP.

4.1. Activar el modo de depuración (Debug Mode)

Para ver el error real, activa el modo debug de PrestaShop:

Abre el archivo config/defines.inc.php (en la raíz de tu tienda).
Busca la línea: define('_PS_MODE_DEV_', false);
Cámbiala a: define('_PS_MODE_DEV_', true);
Guarda el archivo. Ahora, al cargar tu tienda, verás los errores PHP detallados en lugar de una pantalla en blanco.

[INFO] Una vez hayas solucionado el problema, NO OLVIDES volver a poner false en esa línea. Si no, tu tienda mostrará información sensible a los visitantes.

4.2. Deshabilitar temporalmente todos los módulos no nativos

Si el error aparece después de instalar un módulo, puedes desactivarlos todos desde la base de datos:

Ve a Syspanel > Base de Datos > phpMyAdmin.
Selecciona tu base de datos de PrestaShop.
Busca la tabla ps_module (o prestashop_module según el prefijo).
Haz clic en SQL y ejecuta esta consulta (cambia ps_ por tu prefijo si es diferente):
```
UPDATE ps_module SET active = 0 WHERE id_module > 0;
```
Luego, desde el Back Office (si ya puedes acceder), ve a Módulos > Gestor de Módulos y actívalos uno a uno para identificar el culpable.

5. Problemas de Permisos de Archivos

PrestaShop necesita permisos específicos en archivos y carpetas para funcionar.

5.1. Verificar permisos desde Syspanel

En el Administrador de archivos de Syspanel, puedes ver los permisos (por ejemplo, 755, 644).

Carpetas: Deben tener permisos 755 (o 750).
Archivos: Deben tener permisos 644 (o 640).
Archivos de configuración: El archivo app/config/parameters.php debe tener permisos 644 o 600 para que no sea legible por otros usuarios del servidor.

[WARNING] Nunca pongas permisos 777 a nada. Es un grave riesgo de seguridad.

Para corregir permisos de forma masiva, puedes usar el comando en la terminal (si tienes acceso SSH) o pedir ayuda a soporte. Desde Syspanel, puedes seleccionar varias carpetas y cambiar permisos.

6. El Rol de la Configuración del Servidor (Syspanel)

Recuerda que Syspanel es la herramienta que gestiona tu servidor. Si nada de lo anterior funciona, revisa estos puntos:

6.1. Firewall o Reglas de Seguridad

A veces, el firewall del servidor bloquea las conexiones a la base de datos. En Syspanel, busca la sección "Firewall" o "Seguridad". Asegúrate de que el puerto 3306 (MySQL) esté abierto para conexiones locales (desde el propio servidor).

6.2. Versión de PHP

PrestaShop 8 necesita PHP 7.3 o superior (idealmente 8.0 o 8.1). PrestaShop 1.6 necesita PHP 5.6 o 7.0. En Syspanel, ve a Servicios > PHP y verifica que la versión sea la correcta para tu PrestaShop.

[TIP] Si cambias la versión de PHP desde Syspanel, recuerda que tu tienda podría dejar de funcionar si la nueva versión no es compatible. Hazlo con cuidado.

7. Preguntas Frecuentes (FAQ)

P: ¿Qué hago si veo "Error 500 Internal Server Error"?
R: Activa el modo debug (paso 4.1) para ver el error real. Si no puedes, revisa los logs de error del servidor en Syspanel > Logs > Error Log. A menudo es un problema de memoria PHP o un módulo roto.

P: Mi tienda se conectaba bien, pero de repente dejó de funcionar después de una actualización de PrestaShop.
R: Las actualizaciones pueden cambiar la estructura de la base de datos. Prueba a restaurar una copia de seguridad reciente desde Syspanel > Backups. Si no tienes, contacta con soporte.

P: ¿Cómo sé si el problema es de mi internet o del servidor?
R: Prueba a acceder a tu tienda desde otro dispositivo o red (por ejemplo, desde el móvil con datos). Si falla igual, es problema del servidor. Si funciona, es tu conexión local.

P: ¿Puedo solucionar un error de conexión sin perder datos?
R: Sí, en la mayoría de los casos. Los errores de conexión a la base de datos o de caché no borran tus productos, clientes o pedidos. Siempre que no borres la base de datos, tus datos están seguros.

8. Resumen y Consejo Final

Para solucionar conexión PrestaShop, sigue esta jerarquía:

Revisa Syspanel: Servicios, recursos, base de datos.
Verifica credenciales: El archivo parameters.php debe tener los datos correctos.
Limpia la caché: Manualmente desde el administrador de archivos.
Activa el modo debug: Para ver el error exacto.
Desactiva módulos: Si el error es reciente, prueba a desactivarlos todos.

[WARNING] Si después de todo esto sigues sin poder acceder a tu tienda, no dudes en contactar con nuestro equipo de ayuda PrestaShop Syspanel. Proporciónanos el error exacto que ves (con el modo debug activado) y los pasos que has seguido. Estamos aquí para ayudarte a que tu tienda vuelva a funcionar.

Recuerda: la paciencia es clave. La mayoría de los problemas de conexión se solucionan con unos pocos clics en Syspanel o editando un archivo de texto. ¡Tu tienda online estará operativa en poco tiempo!