Error de conexión a base de datos en PrestaShop: Solución rápida

Introducción: ¿Por qué aparece el error de conexión a la base de datos en PrestaShop?

Si tienes una tienda online con PrestaShop y de repente te encuentras con un mensaje como "Error de conexión a la base de datos" o "Link to database cannot be established", no entres en pánico. Es uno de los problemas más comunes en entornos de hosting, pero también uno de los más fáciles de solucionar si sabes por dónde empezar.

Este error significa que PrestaShop no puede comunicarse con el servidor de bases de datos MySQL/MariaDB donde se almacenan tus productos, clientes, pedidos y configuraciones. Las causas pueden ir desde un cambio de contraseña hasta un fallo en el servidor. En esta guía te explicaré paso a paso cómo diagnosticar y resolver este problema, tanto si usas cPanel como si tu hosting utiliza Syspanel (antes conocido como HestiaCP, accesible por el puerto 2106).

## 1. Causas más comunes del error de conexión a la base de datos

Antes de ponernos manos a la obra, identifiquemos qué puede estar fallando:

[INFO] Las causas más frecuentes son:

Contraseña de la base de datos incorrecta o cambiada recientemente.

El usuario de la base de datos no tiene permisos suficientes.

El servidor de bases de datos está caído o sobrecargado.

Los datos de conexión en el archivo settings.inc.php están mal escritos.

El hosting ha cambiado la dirección del servidor MySQL (por ejemplo, de localhost a una IP).

El límite de conexiones simultáneas se ha excedido.

## 2. Primer paso: Verifica que el servidor MySQL esté funcionando

No siempre es culpa de tu configuración. A veces el problema es del servidor.

### 2.1. Si tienes acceso a cPanel

Inicia sesión en tu cPanel.
Busca la sección Bases de datos y haz clic en MySQL Databases o phpMyAdmin.
Si phpMyAdmin se abre sin problemas, el servidor MySQL está activo.
Si no puedes acceder, contacta con tu proveedor de hosting.

### 2.2. Si usas Syspanel (HestiaCP, puerto 2106)

Accede a tu panel escribiendo en el navegador: https://tudominio.com:2106.
Ve a Base de datos y revisa el estado de tus bases de datos.
También puedes usar la herramienta phpMyAdmin desde el mismo panel.

[WARNING] Si el servidor MySQL está caído, ninguna solución local funcionará. En ese caso, abre un ticket con tu soporte técnico.

## 3. Segundo paso: Revisa el archivo de configuración de PrestaShop

PrestaShop guarda los datos de conexión en el archivo app/config/parameters.php (versiones 1.7+) o config/settings.inc.php (versiones 1.6 y anteriores). Aquí es donde suele estar el error.

### 3.1. Accede al archivo mediante FTP o File Manager

Puedes usar un cliente FTP (como FileZilla) o el File Manager de tu panel de control.

En cPanel: Ve a Archivos > Administrador de archivos.
En Syspanel: Ve a Web > File Manager (o accede por FTP).

### 3.2. Localiza el archivo correcto

Para PrestaShop 1.7+: tudominio.com/app/config/parameters.php
Para PrestaShop 1.6: tudominio.com/config/settings.inc.php

### 3.3. Edita con cuidado

Abre el archivo con un editor de texto plano (nada de Word). Busca estas líneas:

'database_host' => 'localhost',
'database_name' => 'nombre_base',
'database_user' => 'usuario_base',
'database_password' => 'contraseña_base',

[TIP] En versiones 1.6, las variables se llaman DB_NAME, DB_USER, DB_PASSWD, etc.

### 3.4. Verifica que los datos coincidan con los de tu hosting

Si no recuerdas los datos exactos, puedes obtenerlos desde tu panel:

cPanel: Ve a Bases de datos > MySQL Databases. Allí verás tus bases y usuarios.
Syspanel: Ve a Base de datos y selecciona la base que usa tu PrestaShop.

[WARNING] Asegúrate de que el usuario tenga todos los privilegios sobre la base de datos. En cPanel puedes asignarlos desde la misma sección. En Syspanel, la opción suele estar en los detalles de la base.

## 4. Tercer paso: Prueba la conexión manualmente

Si aún tienes dudas, puedes hacer una prueba directa para descartar que el problema sea de PrestaShop.

### 4.1. Crea un archivo PHP de prueba

Crea un archivo llamado testdb.php con el siguiente contenido:

<?php
$link = mysqli_connect('localhost', 'usuario_base', 'contraseña_base', 'nombre_base');
if (!$link) {
    die('Error de conexión: ' . mysqli_connect_error());
}
echo '¡Conexión exitosa!';
mysqli_close($link);
?>

Sustituye localhost, usuario_base, contraseña_base y nombre_base por tus datos reales.
Sube el archivo a la raíz de tu tienda (carpeta public_html o www).
Accede desde el navegador: https://tudominio.com/testdb.php

Si ves "¡Conexión exitosa!", el problema está en PrestaShop, no en la base de datos.
Si ves un error, los datos son incorrectos o el servidor MySQL no responde.

[INFO] Borra este archivo después de la prueba por seguridad.

## 5. Cuarto paso: Soluciones rápidas para problemas comunes

### 5.1. Cambiaste la contraseña recientemente

Si has modificado la contraseña de la base de datos en cPanel o Syspanel, debes actualizarla también en el archivo de configuración de PrestaShop.

Ve a tu panel y genera una nueva contraseña segura.
Edita el archivo parameters.php o settings.inc.php y cambia el valor de database_password.
Guarda los cambios y recarga tu tienda.

### 5.2. El hosting cambió el servidor MySQL

Algunos proveedores cambian localhost por una IP o un nombre de host como mysql.tudominio.com.

Revisa la documentación de tu hosting o pregunta al soporte.
Actualiza el valor de database_host en el archivo de configuración.

### 5.3. Problemas de permisos de usuario

En cPanel:

Ve a MySQL Databases.
En la sección Add User to Database, selecciona el usuario y la base.
Marca TODOS LOS PRIVILEGIOS y guarda.

En Syspanel:

Ve a Base de datos > selecciona la base.
Busca la opción de Usuarios y asigna privilegios completos.

## 6. Quinto paso: Restaura una copia de seguridad del archivo de configuración

Si has editado el archivo y algo salió mal, siempre puedes restaurar una copia de seguridad.

Si tienes una copia de seguridad del sitio, extrae el archivo parameters.php o settings.inc.php original.
Si no, contacta con tu hosting para que te proporcionen los datos de conexión correctos.

[TIP] Antes de hacer cambios, siempre crea una copia de seguridad del archivo original. Así puedes revertir fácilmente.

## 7. Sexto paso: Verifica los logs de error

Los logs pueden darte pistas adicionales.

En cPanel: Ve a Métricas > Errores.
En Syspanel: Los logs suelen estar en /var/log/ o puedes verlos desde el panel en Administración > Registros.

Busca mensajes como:

Access denied for user 'usuario'@'localhost'
Can't connect to MySQL server on 'localhost'

## 8. Séptimo paso: Reinstala PrestaShop conservando los datos (solo como último recurso)

Si nada funciona, puedes reinstalar PrestaShop sin perder tus datos:

Haz una copia de seguridad de la base de datos (desde phpMyAdmin).
Descarga una copia limpia de PrestaShop.
Sube los archivos (excepto la carpeta img y el archivo de configuración).
Ejecuta el instalador y, cuando pida la base de datos, usa los datos correctos.
Restaura tu base de datos desde la copia de seguridad.

[WARNING] Este proceso es avanzado. Si no te sientes seguro, pide ayuda a un profesional.

## 9. Preguntas frecuentes (FAQ)

### ¿Puedo solucionar este error sin acceso al panel de control?

Sí, si tienes acceso FTP puedes editar el archivo de configuración. Pero necesitarás los datos de conexión, que normalmente los proporciona tu hosting.

### ¿El error puede deberse a un plugin o tema?

Rara vez. Los plugins no modifican los datos de conexión a la base de datos. Sin embargo, después de instalar un módulo, podrías tener conflictos que afecten al rendimiento, pero no a la conexión en sí.

### ¿Qué hago si el error aparece después de migrar el hosting?

Es muy común. Al migrar, los datos de conexión cambian. Debes actualizar el archivo parameters.php o settings.inc.php con los nuevos valores de tu nuevo hosting.

### ¿Cómo evito este error en el futuro?

Guarda siempre los datos de conexión en un lugar seguro.
No cambies contraseñas sin actualizar PrestaShop.
Realiza copias de seguridad periódicas.
Mantén tu PrestaShop actualizado.

## 10. Conclusión

El error de conexión a la base de datos en PrestaShop puede parecer grave, pero en la mayoría de los casos se soluciona revisando tres cosas: el estado del servidor MySQL, los datos en el archivo de configuración y los permisos del usuario. Ya sea que uses cPanel o Syspanel (puerto 2106), los pasos son similares y accesibles para cualquier usuario.

Si después de seguir esta guía el problema persiste, no dudes en contactar con tu proveedor de hosting. Ellos tienen acceso directo a los servidores y pueden detectar problemas que desde tu panel no ves.

[TIP] Recuerda: la paciencia y la metodología son tus mejores aliadas. Ve paso a paso y no modifiques archivos sin antes hacer una copia de seguridad.

¡Espero que tu tienda vuelva a funcionar en pocos minutos!