Error de conexión a base de datos en PrestaShop: Solución Syspanel

¡Hola! Soy el técnico de soporte amigable. Hoy vamos a resolver juntos uno de los problemas más comunes y frustrantes que puedes encontrar al gestionar tu tienda PrestaShop: el temido error de conexión a la base de datos. Esa pantalla blanca o mensaje de error suele aparecer de repente, pero no te preocupes: vamos a desglosarlo paso a paso, especialmente si gestionas tu servidor desde Syspanel (nuestro panel de control, accesible por el puerto 2106). Al final de esta guía, sabrás exactamente qué hacer para recuperar tu tienda.

¿Qué significa exactamente "error de conexión a la base de datos"?

Imagina que tu tienda PrestaShop es una biblioteca enorme. Los libros (productos, clientes, pedidos) están guardados en un almacén llamado base de datos. Cuando un cliente entra a tu web, PrestaShop necesita ir a ese almacén a buscar la información. Si la llave para abrir la puerta no funciona, o si el almacén está cerrado, tu tienda no puede mostrar nada. Eso es, en esencia, el error conexión base datos PrestaShop.

Los síntomas típicos son:

Pantalla en blanco con el texto: "Error de conexión a la base de datos".
Mensaje como: "Link to database cannot be established".
La tienda funciona a ratos y de repente deja de cargar.
Al acceder al backoffice, aparece un error similar.

Causas más comunes del fallo (y cómo identificarlas desde Syspanel)

Antes de lanzarnos a soluciones, es clave entender por qué ocurre. Las causas suelen ser muy concretas, y con Syspanel (accede a través de tudominio.com:2106) podemos diagnosticarlas en minutos.

1. Credenciales incorrectas (la causa más frecuente)

PrestaShop guarda en un archivo llamado app/config/parameters.php los datos de acceso a la base de datos: nombre de la base, usuario y contraseña. Si cambiaste la contraseña de la base de datos desde Syspanel, o si al migrar tu tienda no actualizaste este archivo, la conexión falla.

2. La base de datos está caída o no responde

El servidor de bases de datos (MySQL/MariaDB) puede haberse detenido por un error, un pico de memoria o una mala configuración. En Syspanel, podemos verificar su estado al instante.

3. El usuario de la base de datos perdió permisos

A veces, al restaurar una copia de seguridad o al crear un nuevo usuario desde Syspanel, este no tiene permisos completos sobre la base de datos. PrestaShop necesita permisos para leer, escribir y modificar tablas.

4. El servidor se quedó sin espacio en disco

Si el disco duro del servidor está lleno, el motor de base de datos no puede escribir nuevos datos ni siquiera iniciar. Esto es más común de lo que parece.

5. Puerto o host incorrecto

Normalmente, la base de datos está en el mismo servidor (localhost o 127.0.0.1), pero si migraste a un servidor externo o cambiaste la configuración de red, el puerto (por defecto 3306) o el host pueden ser incorrectos.

Paso a paso: Cómo solucionar el error desde Syspanel

Vamos a la acción. Sigue estos pasos en orden. No te saltes ninguno, ya que el diagnóstico es progresivo.

Paso 1: Verificar el estado del servicio de base de datos en Syspanel

Lo primero es asegurarnos de que el motor de bases de datos está funcionando.

Inicia sesión en Syspanel usando tu navegador: https://tudominio.com:2106 (recuerda, el puerto es el 2106).
Busca en el menú lateral o en el panel principal una sección llamada "Servicios" o "Service Status".
Localiza la línea que dice "MySQL" o "MariaDB".
Verás un indicador: verde (funcionando) o rojo (detenido).

[WARNING] Si ves el indicador en rojo, no entres en pánico. Simplemente haz clic en el botón "Reiniciar" o "Start" que aparece al lado. Espera 10 segundos y vuelve a comprobar. Si se pone en verde, ¡prueba tu tienda! El problema era que el servicio se había caído.

Si el servicio no arranca o se detiene de nuevo, anota el mensaje de error que aparezca. Puede indicar un problema de configuración o falta de espacio en disco.

Paso 2: Comprobar el espacio en disco desde Syspanel

Un disco lleno puede impedir que MySQL arranque.

En Syspanel, busca "System Info" o "Disk Usage".
Revisa el porcentaje de uso del disco principal (suele ser / o /home).
Si está al 95% o más, tienes el culpable.

[INFO] Si el disco está lleno, necesitas liberar espacio. Puedes:

Eliminar copias de seguridad antiguas desde Syspanel (sección "Backup").
Revisar la carpeta de logs de tu web (normalmente en /var/log/ o dentro de la carpeta de tu dominio en /home/usuario/web/tudominio/logs/).
Vaciar la papelera de reciclaje de Syspanel si existe.

Una vez liberado espacio, vuelve al Paso 1 e intenta arrancar el servicio MySQL.

Paso 3: Revisar y corregir las credenciales en PrestaShop

Si el servicio funciona y hay espacio, el problema suele ser de configuración.

Desde Syspanel, ve a la sección "File Manager" o "Administrador de Archivos".
Navega hasta la carpeta raíz de tu tienda PrestaShop (normalmente dentro de /home/usuario/web/tudominio/public_html/).
Busca la carpeta app/config/ y dentro el archivo parameters.php.
Haz clic derecho sobre parameters.php y selecciona "Editar" (o "Edit").

Verás un contenido similar a este (no te asustes, es código legible):

'database_host' => 'localhost',
'database_port' => '3306',
'database_name' => 'tu_base_de_datos',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',

Ahora, necesitas verificar estos datos. Para ello:

Abre otra pestaña de Syspanel y ve a la sección "Bases de Datos" o "Databases".
Ahí verás listadas todas tus bases de datos. Anota el nombre exacto de la base de datos de tu PrestaShop.
Haz clic en el nombre de la base de datos o en un botón de "Usuarios" para ver qué usuarios tienen acceso. Verás el nombre de usuario asociado.

[TIP] Copia y pega el nombre de la base de datos y del usuario exactamente como aparecen en Syspanel (respetando mayúsculas y minúsculas) en el archivo parameters.php. La contraseña es la que pusiste al crear el usuario. Si no la recuerdas, puedes cambiarla desde Syspanel:

En la sección de Bases de Datos, busca la opción "Cambiar contraseña" o "Edit user".
Establece una nueva contraseña segura.
Actualiza inmediatamente ese mismo valor en el archivo parameters.php de PrestaShop.

Guarda los cambios en parameters.php y cierra el editor.

Paso 4: Verificar y reparar los permisos del usuario

A veces el usuario existe y la contraseña es correcta, pero no tiene todos los permisos necesarios.

En Syspanel, en la sección "Bases de Datos", selecciona tu base de datos.
Busca la opción "Gestionar permisos" o "Manage privileges".
Asegúrate de que el usuario de PrestaShop tenga marcados TODOS los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, etc.). La opción más segura es marcar "ALL PRIVILEGES".
Guarda los cambios.

Paso 5: Probar la conexión manualmente (opcional pero muy útil)

Si aún falla, podemos hacer una prueba directa desde el servidor.

En Syspanel, busca la opción "Terminal" o "Console" (puede que necesites activarla en la configuración de tu plan).
Escribe el siguiente comando y pulsa Enter:
```
mysql -u tu_usuario -p -h localhost tu_base_de_datos
```
Sustituye tu_usuario y tu_base_de_datos por los reales.
Te pedirá la contraseña. Escríbela (no se ve mientras escribes) y pulsa Enter.
Si ves algo como mysql>, ¡la conexión funciona perfectamente! El problema está en el archivo parameters.php (vuelve al Paso 3).
Si ves un error como "Access denied for user", la contraseña o el usuario son incorrectos (revisa permisos y contraseña en Syspanel).
Si ves "Can't connect to MySQL server", el servicio no está corriendo o el host no es 'localhost' (vuelve al Paso 1).

Para salir de la consola de MySQL, escribe exit; y pulsa Enter.

Soluciones avanzadas (si nada de lo anterior funciona)

Si has seguido todos los pasos y el solucionar error base datos PrestaShop sigue siendo un misterio, prueba esto:

Forzar la regeneración del archivo parameters.php: A veces el archivo está corrupto. Puedes descargarlo, borrarlo de tu servidor (haz antes una copia de seguridad) y luego ejecutar el instalador de PrestaShop (/install/) para que lo genere de nuevo. Esto es más drástico, pero efectivo.
Revisar los logs de error: En Syspanel, busca la sección "Logs" o "Error Logs". Busca errores recientes de PHP o de MySQL. Te darán pistas muy concretas.
Aumentar los límites de memoria de MySQL: Desde Syspanel, en la configuración de MySQL (a veces en "Server Config"), puedes aumentar max_allowed_packet o innodb_buffer_pool_size. Si no te sientes seguro, pide ayuda a nuestro soporte técnico.

Preguntas Frecuentes (FAQ)

P: ¿Por qué aparece el error después de restaurar una copia de seguridad?
R: Es muy común. La copia de seguridad puede tener datos antiguos de conexión. Asegúrate de que el archivo app/config/parameters.php de la copia tenga las credenciales actuales de tu base de datos en Syspanel. A veces la base de datos de la copia tiene un nombre diferente.

P: Cambié la contraseña de mi base de datos en Syspanel y ahora la tienda da error. ¿Qué hago?
R: Has dado en el clavo. Cada vez que cambies la contraseña desde Syspanel, debes actualizarla manualmente en el archivo app/config/parameters.php de PrestaShop. Sigue el Paso 3 de esta guía.

P: El servicio MySQL está verde en Syspanel, pero la tienda sigue sin funcionar. ¿Qué puede ser?
R: Revisa el archivo parameters.php con lupa. Un error tipográfico en el nombre de la base de datos o del usuario es la causa más probable. También verifica que el usuario tenga todos los permisos (Paso 4).

P: ¿Puedo acceder a Syspanel desde cualquier navegador?
R: Sí, pero recuerda que la dirección es https://tudominio.com:2106. Asegúrate de que el puerto 2106 no esté bloqueado por tu firewall local o el de tu empresa.

[INFO] Recuerda que, como técnico de soporte, siempre puedes abrir un ticket desde el propio Syspanel si el problema persiste. Describe los pasos que ya has seguido (por ejemplo: "Revisé el servicio MySQL, está verde. Verifiqué espacio en disco, está al 60%. Corregí credenciales en parameters.php y permisos del usuario, pero el error persiste"). Esto nos ayudará a ayudarte más rápido.

Espero que esta guía te haya servido. Recuerda que la paciencia y el orden son clave. ¡No te rindas! Tu tienda PrestaShop volverá a funcionar.