Errores de conexión a base de datos: soluciones rápidas

Introducción: ¿Por qué falla la conexión a la base de datos?

Conectar una base de datos es el paso fundamental para que cualquier sitio web dinámico funcione. Cuando este proceso falla, el resultado es casi siempre una pantalla en blanco o un mensaje de error crítico que impide ver el contenido. Esto puede ocurrir tanto en WordPress como en PrestaShop, dos de los sistemas de gestión de contenidos (CMS) más populares.

Los errores de conexión a la base de datos pueden deberse a múltiples causas: desde un simple cambio de contraseña hasta un problema de permisos en el servidor. Lo bueno es que la mayoría tienen solución y no requieren ser un experto en programación. En este artículo, vamos a desglosar los errores más comunes al conectar una base de datos y te enseñaremos paso a paso cómo solucionarlos.

Error 1: "Error establishing a database connection" (WordPress)

Este es, sin duda, el error más temido por los usuarios de WordPress. Aparece de repente y el sitio se vuelve completamente inaccesible. Las causas principales son:

Credenciales incorrectas en el archivo wp-config.php.
El servidor de base de datos no responde (caído o bloqueado).
Problemas con el prefijo de las tablas o corrupción de la base de datos.

Solución paso a paso

Verifica las credenciales en wp-config.php.
Accede a tu hosting por FTP o mediante el administrador de archivos de Syspanel (recuerda que el puerto de acceso es el 2106). Localiza el archivo wp-config.php en la raíz de tu instalación de WordPress. Busca las siguientes líneas:
```
define('DB_NAME', 'nombre_base');
define('DB_USER', 'usuario_base');
define('DB_PASSWORD', 'contraseña');
define('DB_HOST', 'localhost');
```
Comprueba que el nombre, usuario y contraseña coincidan exactamente con los datos de tu base de datos. Un error común es copiar un espacio en blanco o una tilde mal colocada.
Prueba la conexión desde phpMyAdmin.
Desde Syspanel, accede a phpMyAdmin (normalmente en el panel de control de bases de datos). Intenta iniciar sesión con las mismas credenciales que tienes en el archivo. Si no puedes entrar, el problema está en la base de datos, no en WordPress.
Revisa el servidor de base de datos (DB_HOST).
En la mayoría de los hosting compartidos, DB_HOST es localhost. Sin embargo, algunos proveedores usan direcciones como mysql.servidor.com o 127.0.0.1. Consulta con tu soporte técnico si tienes dudas.
Repara la base de datos.
Si las credenciales son correctas y el servidor responde, añade esta línea en wp-config.php (justo antes del require_once):
```
define('WP_ALLOW_REPAIR', true);
```
Luego visita tusitio.com/wp-admin/maint/repair.php. Aparecerá una pantalla para reparar tablas. Una vez hecho, elimina esa línea del archivo por seguridad.

Error 2: "Cannot connect to database" (PrestaShop)

En PrestaShop, un error de conexión suele mostrar un mensaje similar a "Cannot connect to database" o simplemente una página en blanco. Las causas más frecuentes son:

Archivo settings.inc.php mal configurado.
Versión de PHP incompatible con la base de datos.
Permisos incorrectos del usuario de la base de datos.

Solución paso a paso

Revisa el archivo settings.inc.php.
Este archivo se encuentra en /config/settings.inc.php. Ábrelo y verifica que los parámetros _DB_SERVER_, _DB_NAME_, _DB_USER_ y _DB_PASSWD_ estén correctos. Ejemplo:
```
define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_base');
define('_DB_USER_', 'usuario_base');
define('_DB_PASSWD_', 'contraseña');
```
Un error común es que el servidor de base de datos no sea localhost sino el nombre de un servidor remoto. Si tu hosting usa Syspanel, normalmente es localhost.
Comprueba la versión de PHP.
PrestaShop requiere PHP 7.1 o superior para versiones modernas. Si tu hosting tiene PHP 5.6, la conexión puede fallar. Desde Syspanel puedes cambiar la versión de PHP en la sección "PHP Selector". Selecciona una versión compatible (por ejemplo, 7.4 u 8.0).
Verifica los permisos del usuario.
Desde phpMyAdmin, asegúrate de que el usuario de la base de datos tenga todos los privilegios sobre la base de datos (SELECT, INSERT, UPDATE, DELETE, etc.). Si no, puedes concederlos con una consulta SQL:
```
GRANT ALL PRIVILEGES ON nombre_base.* TO 'usuario_base'@'localhost';
FLUSH PRIVILEGES;
```

Prueba la conexión manualmente.
Crea un archivo test.php en la raíz de PrestaShop con este contenido:

<?php
$conexion = mysqli_connect('localhost', 'usuario_base', 'contraseña', 'nombre_base');
if (!$conexion) {
    die('Error: ' . mysqli_connect_error());
} else {
    echo 'Conexión exitosa';
}

Si ves "Conexión exitosa", el problema está en PrestaShop, no en la base de datos.

Error 3: "The server requested authentication method unknown to the client" (MySQL 8+)

Este error es cada vez más común porque las nuevas versiones de MySQL (8.0 en adelante) usan un método de autenticación más seguro llamado caching_sha2_password. Algunas aplicaciones antiguas (como WordPress o PrestaShop con PHP 7.0) no lo soportan.

Solución

Cambia el método de autenticación del usuario.
Conéctate a MySQL como root (desde phpMyAdmin o línea de comandos) y ejecuta:
```
ALTER USER 'usuario_base'@'localhost' IDENTIFIED WITH mysql_native_password BY 'contraseña';
FLUSH PRIVILEGES;
```
Actualiza PHP a una versión reciente.
Desde Syspanel, cambia a PHP 7.4 o superior, que ya incluye soporte para caching_sha2_password. Si usas PHP 8.0, el problema debería desaparecer.
Configura el servidor para usar mysql_native_password por defecto.
Si tienes acceso al archivo my.cnf (en servidores dedicados o VPS), añade:
```
[mysqld]
default_authentication_plugin=mysql_native_password
```
Luego reinicia MySQL.

Error 4: "Too many connections" (Sobrecarga de conexiones)

Este error ocurre cuando el número de conexiones simultáneas a la base de datos supera el límite permitido. Es común en sitios con mucho tráfico o con plugins mal optimizados en WordPress.

Solución

Aumenta el límite de conexiones en MySQL.
Desde Syspanel (si tienes acceso a la configuración de MySQL) o mediante SSH, edita my.cnf y cambia:
```
max_connections = 500   # Aumenta este valor (por defecto suele ser 150)
```
Luego reinicia MySQL.
Optimiza las consultas y plugins.
En WordPress, desactiva plugins que hagan muchas consultas a la base de datos (por ejemplo, contadores de visitas, estadísticas en tiempo real). Usa herramientas como Query Monitor para identificar consultas lentas.
Implementa un sistema de caché.
Instala un plugin de caché como W3 Total Cache o WP Super Cache. Esto reduce drásticamente las conexiones a la base de datos porque el contenido se sirve desde archivos estáticos.
Revisa los procesos bloqueados.
En phpMyAdmin, ejecuta:
```
SHOW PROCESSLIST;
```
Si ves muchos procesos en estado "Sleep" o "Locked", puedes matarlos con:
```
KILL id_del_proceso;
```

Error 5: "Connection refused" o "Host no permitido"

Este error indica que el servidor de base de datos está activo pero rechaza la conexión desde la IP o el host desde el que intentas acceder.

Solución

Verifica los permisos de host del usuario.
En MySQL, los usuarios se definen con un host específico (por ejemplo, 'usuario'@'localhost'). Si tu aplicación se conecta desde un servidor remoto, el host debe coincidir. Ejecuta:
```
SELECT user, host FROM mysql.user;
```
Si tu usuario solo tiene localhost, pero la conexión se hace desde 192.168.1.10, debes crear un nuevo usuario o modificar el existente:
```
CREATE USER 'usuario_base'@'192.168.1.10' IDENTIFIED BY 'contraseña';
GRANT ALL PRIVILEGES ON nombre_base.* TO 'usuario_base'@'192.168.1.10';
FLUSH PRIVILEGES;
```
Comprueba el firewall del servidor.
Si usas Syspanel, asegúrate de que el puerto 3306 (MySQL) esté abierto. Puedes verificarlo desde la sección "Firewall" o "Seguridad". En servidores Linux, usa:
```
sudo ufw status
```
Si está bloqueado, permite el puerto:
```
sudo ufw allow 3306
```
Usa la dirección IP correcta en DB_HOST.
En lugar de localhost, prueba con 127.0.0.1 o la IP pública del servidor de base de datos (si es remoto).

Error 6: "Base de datos no encontrada" (Database does not exist)

Este error es más simple de lo que parece: la base de datos que intentas usar no existe en el servidor.

Solución

Crea la base de datos desde Syspanel.
Ve a la sección "Bases de datos" y crea una nueva con el mismo nombre que aparece en tu archivo de configuración. Anota el usuario y contraseña.
Importa un backup si es necesario.
Si ya tenías datos, exporta un backup desde otra base de datos (por ejemplo, desde un hosting anterior) e impórtalo en la nueva base de datos usando phpMyAdmin.
Verifica el nombre en el archivo de configuración.
Asegúrate de que no haya errores tipográficos. A veces, por accidente, se escribe un nombre diferente o se incluye un guion bajo de más.

FAQ: Preguntas frecuentes sobre errores de conexión

P: ¿Cómo sé si mi base de datos está caída?
R: Puedes probar conectándote desde phpMyAdmin. Si no puedes acceder, probablemente el servidor de base de datos está detenido. Contacta a tu proveedor de hosting.

P: ¿Qué hago si olvido la contraseña de la base de datos?
R: Desde Syspanel, puedes cambiar la contraseña de cualquier usuario de base de datos en la sección "Bases de datos". Luego actualiza el archivo de configuración de tu CMS.

P: ¿Puedo usar la misma base de datos para WordPress y PrestaShop?
R: Técnicamente sí, pero no es recomendable porque los prefijos de las tablas pueden chocar. Es mejor usar bases de datos separadas.

P: ¿Por qué después de migrar mi sitio aparece "Error establishing a database connection"?
R: Lo más probable es que las credenciales en wp-config.php o settings.inc.php sigan apuntando al hosting anterior. Revisa y actualiza los datos.

P: ¿Qué es el puerto 2106 de Syspanel?
R: Syspanel (anteriormente HestiaCP) utiliza el puerto 2106 para su panel de control web. No tiene relación directa con la base de datos, pero es útil para acceder a las herramientas de administración.

Conclusión: No te asustes, casi todo tiene solución

Los errores de conexión a la base de datos pueden parecer graves, pero en la mayoría de los casos se resuelven con unos pocos pasos. Lo importante es mantener la calma y seguir un orden lógico: verificar credenciales, comprobar el servidor, revisar permisos y, si todo falla, consultar los logs del servidor.

Recuerda que tanto WordPress como PrestaShop tienen comunidades enormes y foros donde puedes buscar ayuda. Y si usas Syspanel, su panel de control facilita mucho la gestión de bases de datos. Con esta guía, esperamos que puedas solucionar cualquier problema de conexión que se te presente. ¡Buena suerte!