🎨 Sysprovider Code
Sysprovider LogoWiki
🇪🇸Hosting español para ecommerce

Errores comunes al conectar a una base de datos y cómo solucionarlos

Actualizado el 18 de enero de 2026

Conectar una base de datos es como abrir la puerta de tu trastero: parece sencillo, pero si no tienes la llave correcta, la cerradura está oxidada o estás llamando al edificio equivocado, te quedarás fuera. Si estás viendo mensajes de error en tu web, tienda online o aplicación, no te preocupes: el 90% de las veces la solución es más simple de lo que parece.

En esta guía extensa vamos a desglosar los errores de conexión a bases de datos más comunes, desde el famoso Access denied hasta el temido Connection refused. Te explicaré qué significan, por qué ocurren y, sobre todo, cómo solucionarlos paso a paso, incluso si nunca has tocado un panel de control en tu vida.

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

Antes de entrar en materia, imagina que tu aplicación (WordPress, PrestaShop, una app a medida) es una persona que necesita hablar con otra (la base de datos). Para que la conversación fluya, necesitan tres cosas:

  1. Dirección correcta: Dónde vive la base de datos (normalmente localhost o una IP).
  2. Credenciales válidas: Un nombre de usuario y una contraseña que existan.
  3. Permiso de acceso: Que el usuario tenga permitido entrar por esa puerta y usar esa base de datos concreta.

Si falla cualquiera de estos tres puntos, obtendrás un error. Vamos a ver los más típicos y sus curas.

Error 1: "Access denied for user" (Acceso denegado)

Este es, con diferencia, el error de conexión a base de datos más habitual. Verás un mensaje similar a este:

SQLSTATE[HY000] [1045] Access denied for user 'usuario'@'localhost' (using password: YES)

O en WordPress: "Error al establecer la conexión con la base de datos".

¿Qué significa?

Literalmente, la base de datos te está diciendo: "No te conozco o no me gusta tu contraseña". El servidor ha recibido tu petición, ha visto tu nombre de usuario y tu contraseña, pero ha rechazado la combinación.

Causas más frecuentes

  • Contraseña mal escrita: Puede tener un espacio al final, una mayúscula cambiada o un carácter especial que se ha copiado mal desde el gestor.
  • Usuario incorrecto: Estás usando un usuario que no existe o que pertenece a otra base de datos.
  • Permisos insuficientes: El usuario existe, pero no tiene privilegios para conectarse desde localhost (o desde el servidor remoto que estás usando).
  • Archivo de configuración desactualizado: Cambiaste la contraseña en el panel y no actualizaste el archivo de tu web (por ejemplo, wp-config.php o .env).

Cómo solucionarlo paso a paso

  1. Revisa el archivo de configuración: Abre el archivo donde están los datos de conexión (normalmente config.php, wp-config.php, .env o database.php).
  2. Verifica que el nombre de usuario y la contraseña coinciden EXACTAMENTE con los que creaste en tu panel de control (cPanel, Plesk o Syspanel).
  3. Cuidado con los prefijos: En muchos hosting compartidos, el usuario se llama usuario_nombre (con el prefijo de la cuenta incluido). Asegúrate de copiar el nombre completo.
  4. Cambia la contraseña a propósito: Ve a tu panel de control, busca "Bases de datos MySQL" y usa la opción "Cambiar contraseña". Elige una sencilla (solo para probar), actualiza el archivo de configuración y prueba de nuevo. Si funciona, ya sabes que el problema era la contraseña.

[TIP] Si usas Syspanel (el panel de control que tiene el puerto 2106 para acceso), ve a la sección "Bases de datos", selecciona tu DB y usa la opción "Cambiar contraseña". Copia la nueva clave y pégala directamente en tu archivo de configuración para evitar errores de tipeo.

Error 2: "Unknown database" (Base de datos desconocida)

Otro clásico. El mensaje suele ser:

SQLSTATE[HY000] [1049] Unknown database 'nombre_db'

¿Qué significa?

El servidor te ha dejado pasar (usuario y contraseña correctos), pero le pides usar una base de datos que no existe en ese servidor. Es como tener la llave de tu casa, pero intentar abrir la puerta del vecino.

Causas más frecuentes

  • Error tipográfico: El nombre de la base de datos está mal escrito en el archivo de configuración.
  • Prefijo olvidado: Al igual que con el usuario, en hosting compartido la base de datos suele llamarse usuario_nombrebd. Si pones solo nombrebd, no la encontrará.
  • Base de datos borrada: Alguien (o un proceso automático) eliminó la base de datos.

Cómo solucionarlo

  1. Ve a tu panel de control (recuerda: Syspanel usa el puerto 2106).
  2. Busca la lista de bases de datos MySQL existentes.
  3. Copia el nombre EXACTO que aparece en la lista (con mayúsculas, minúsculas y prefijo).
  4. Pega ese nombre en tu archivo de configuración, sustituyendo al que estaba mal.

[WARNING] No intentes "adivinar" el nombre. Cópialo siempre desde el panel. Un solo carácter de diferencia (como un guion bajo _ en lugar de un guion -) provocará este error.

Error 3: "Connection refused" (Conexión rechazada)

Este error es un poco más técnico y da más miedo, pero tiene solución. Verás:

SQLSTATE[HY000] [2002] Connection refused

O en inglés: "Failed to connect to MySQL: Connection refused".

¿Qué significa?

El servidor de base de datos no está escuchando en el puerto que le indicas (normalmente el 3306). Es como llamar a la puerta de una oficina que está cerrada por vacaciones. No es un problema de contraseña, sino de red o de servicio.

Causas más frecuentes

  • El servicio MySQL/MariaDB está caído: El servidor se ha reiniciado y el demonio de la base de datos no ha arrancado.
  • Puerto incorrecto: Estás intentando conectar al puerto 3306, pero el servidor usa otro (a veces por seguridad se cambia a 3307, 3308, etc.).
  • Host incorrecto: Estás usando localhost cuando deberías usar 127.0.0.1 o una IP específica del servidor de base de datos (si es remoto).
  • Firewall bloqueando: Un cortafuegos está bloqueando la conexión externa al puerto 3306.

Cómo solucionarlo

  1. Comprueba el host: Si tu web y tu base de datos están en el mismo servidor, usa localhost. Si la base de datos está en otro servidor (por ejemplo, un servicio de DB en la nube), necesitas la IP o el nombre de host que te han dado.
  2. Verifica el puerto: Añade el puerto explícitamente en la configuración. En MySQL suele ser localhost:3306. Si tu proveedor usa otro, te lo habrá indicado en el panel.
  3. Reinicia el servicio (si tienes acceso SSH o VPS):
    • Si usas un VPS con panel, ve a la sección de servicios y busca "MySQL" o "MariaDB". Haz clic en "Reiniciar".
    • En la terminal, el comando sería: sudo systemctl restart mysql o sudo systemctl restart mariadb.
  4. Revisa el firewall: Si estás en un VPS, asegúrate de que el puerto 3306 esté abierto en las reglas de seguridad (iptables o el firewall del proveedor de la nube).

[INFO] Si estás usando un hosting compartido, rara vez verás "Connection refused" porque el proveedor gestiona el servicio. Si lo ves, contacta con soporte, porque probablemente sea un fallo del servidor.

Error 4: "Too many connections" (Demasiadas conexiones)

Este es menos común, pero muy frustrante. El mensaje:

SQLSTATE[HY000] [1040] Too many connections

¿Qué significa?

El servidor de bases de datos tiene un límite de conexiones simultáneas (por ejemplo, 100). Tu web, o un plugin, o un proceso externo, ha saturado ese límite. Es como un restaurante con todas las mesas ocupadas: no te dejan entrar hasta que alguien salga.

Causas frecuentes

  • Un plugin o script mal optimizado: Deja conexiones abiertas sin cerrar.
  • Picos de tráfico: Muchos visitantes a la vez.
  • Procesos zombis: Consultas que se quedan colgadas.

Cómo solucionarlo

  1. Si es puntual, espera unos minutos: El sistema suele limpiar las conexiones muertas automáticamente.
  2. Reinicia el servicio de base de datos: Desde Syspanel (puerto 2106) o desde la terminal con sudo systemctl restart mysql. Esto libera todas las conexiones de golpe.
  3. Optimiza tu aplicación: Si usas WordPress, revisa si tienes un plugin de caché o de base de datos que esté haciendo demasiadas consultas.
  4. Aumenta el límite (solo si eres administrador del servidor): Puedes editar el archivo my.cnf y subir el valor de max_connections. Pero esto es un parche; lo ideal es optimizar.

[WARNING] No aumentes max_connections a lo loco (por ejemplo, a 1000) si tu servidor tiene poca RAM. Podrías provocar que el servidor entero se caiga por falta de memoria.

Error 5: "Can't connect to local MySQL server through socket"

Este error es más típico en entornos Linux. El mensaje:

ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/var/run/mysqld/mysqld.sock' (2)

¿Qué significa?

Cuando usas localhost, MySQL no usa TCP/IP (red), usa un archivo especial llamado "socket". Si ese archivo no existe o no es accesible, falla.

Causas y soluciones

  • El servicio no ha arrancado: Solución: sudo systemctl start mysql.
  • El archivo socket está en otra ruta: A veces el panel de control lo mueve. Solución: busca el archivo .sock con find / -name "*.sock" 2>/dev/null y actualiza la ruta en tu configuración (normalmente en my.cnf).
  • Permisos del directorio: El usuario de tu aplicación no tiene permisos para leer el socket. Solución: ajusta los permisos del directorio /var/run/mysqld/ a 755 y el archivo a 660.

Guía rápida de verificación (Checklist final)

Si estás desesperado, sigue esta lista de verificación en orden. Resuelve el 95% de los casos:

  1. ¿El servicio está activo? Ve a Syspanel (puerto 2106) o a tu panel y verifica que MySQL/MariaDB tiene un check verde. Si no, reinícialo.
  2. ¿El nombre de la BD es correcto? Cópialo desde el panel, no lo escribas de memoria.
  3. ¿El usuario es correcto? Cópialo también desde el panel. Recuerda el prefijo.
  4. ¿La contraseña es correcta? Cámbiala en el panel y pégala en tu archivo de configuración.
  5. ¿El host es localhost? Si tu web y BD están en el mismo sitio, sí. Si no, usa la IP que te dio tu proveedor.
  6. ¿El puerto es el 3306? A menos que te hayan dicho lo contrario, sí.

Preguntas frecuentes (FAQ)

¿Por qué me da "Access denied" si estoy seguro de que la contraseña es correcta?

A veces el problema es el "host" desde el que te conectas. Si tu web está en servidor1.com y la BD solo acepta conexiones desde localhost, verás ese error. Asegúrate de que el usuario tiene permisos para conectarse desde % (cualquier host) o desde la IP específica de tu web.

¿Puedo usar el mismo usuario para varias bases de datos?

Sí, es posible, pero no recomendable por seguridad. Si lo haces, asegúrate de que ese usuario tiene privilegios solo sobre las bases de datos que necesite.

¿Qué hago si nada de esto funciona?

Si has verificado todo y sigues con el error de conexión base de datos, el problema puede estar en el servidor mismo. Contacta con tu proveedor de hosting y dales el mensaje de error exacto. Ellos tienen herramientas para ver los logs del servidor en tiempo real.

¿Es seguro usar localhost en lugar de 127.0.0.1?

En la mayoría de los casos, sí. La diferencia es que localhost usa el socket de Unix (más rápido) y 127.0.0.1 usa el protocolo TCP/IP (más lento pero más compatible). Si tu configuración falla con localhost, prueba con 127.0.0.1, a veces ayuda.

Conclusión

Los errores de conexión a base de datos son como los resfriados: molestos, pero comunes y curables. La clave está en no entrar en pánico y seguir un método lógico: primero verifica el servicio, luego las credenciales, y finalmente la configuración de red.

Con esta guía, ya tienes el mapa para solucionar DB de forma autónoma. La próxima vez que veas un Access denied o un Unknown database, sonríe, porque ya sabes exactamente qué hacer.

[TIP] Guarda esta guía en tus favoritos. Te aseguro que la volverás a necesitar, porque estos errores son cíclicos en el mundo del desarrollo web.

¿Necesitas ayuda?Son dos de nuestros técnicos, Agustín y Mikel, y están disponibles para resolver cualquier problema.

Hablar con ellos ahora
Agustín y Mikel