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

Errores comunes al conectar con la base de datos y cómo solucionarlos (cPanel, Plesk, DirectAdmin, WordPress, PrestaShop)

Actualizado el 26 de abril de 2026

¿Qué significa realmente “error de conexión a la base de datos”?

Cuando visitas tu web y ves un mensaje como “Error establishing a database connection” (WordPress), “Error de conexión con la base de datos” (PrestaShop) o un simple “500 Internal Server Error”, el problema suele ser el mismo: tu aplicación no puede comunicarse con el servidor donde están guardados tus datos.

Para entenderlo fácilmente, imagina que tu web es un restaurante. La base de datos es la cocina. Si el camarero (PHP) no encuentra la llave de la cocina (credenciales), o la cocina está cerrada (servidor caído), o la puerta ha cambiado (puerto equivocado), el cliente (visitante) se queda sin pedido.

En este artículo vamos a desglosar los errores conexion base de datos más comunes en los principales paneles de control (cPanel, Plesk, DirectAdmin) y en los CMS más usados (WordPress y PrestaShop). Te daré soluciones paso a paso, sin tecnicismos innecesarios.

1. Los 3 errores universales (afectan a todos los paneles)

Antes de entrar en cada panel, debes conocer los tres culpables clásicos. El 90% de los problemas se reducen a esto:

1.1 Credenciales incorrectas (usuario, contraseña o nombre de BD)

El error más básico: escribir mal el nombre de la base de datos, el usuario o la contraseña. En hosting compartido, el nombre de la BD suele llevar un prefijo con tu usuario de cPanel (ej: usuariox_bd1).

Cómo solucionarlo:

  1. Ve a tu panel de control (cPanel, Plesk, DirectAdmin).
  2. Busca la sección “Bases de Datos MySQL”.
  3. Copia exactamente el nombre de la BD y el usuario (no los escribas de memoria).
  4. Restablece la contraseña desde el panel (no la inventes, deja que el sistema la genere).
  5. Actualiza el archivo de configuración de tu web con esos datos exactos.

[WARNING] En cPanel, el usuario y la base de datos suelen compartir prefijo. Si tu usuario es juan_web, la BD podría llamarse juan_bd. No uses solo bd o web, el sistema exige el nombre completo.

1.2 El servidor de BD no está accesible (host o puerto)

Tu web no solo necesita credenciales, también necesita saber dónde está la base de datos. Normalmente es localhost, pero en algunos servidores gestionados o en la nube puede ser una IP como 127.0.0.1 o un puerto distinto al 3306.

Cómo solucionarlo:

  1. Comprueba en la documentación de tu hosting cuál es el hostname de MySQL.
  2. Si usas cPanel, suele ser localhost. Si usas Plesk, a veces es 127.0.0.1.
  3. Abre el archivo de configuración de tu CMS (wp-config.php en WordPress, parameters.php en PrestaShop).
  4. Verifica que el host y el puerto son los correctos.

[INFO] Si tienes un servidor VPS dedicado y cambiaste el puerto de MySQL por seguridad, tu web debe reflejar ese cambio. Un puerto equivocado genera un error inmediato de conexión.

1.3 El servidor de BD está caído o sobrecargado

A veces no es tu culpa. El servidor MySQL puede estar reiniciándose, haber alcanzado el límite de conexiones simultáneas o tener un problema de memoria.

Cómo solucionarlo:

  1. Espera 5-10 minutos y recarga la web.
  2. Revisa el correo de tu proveedor de hosting (suelen avisar de caídas).
  3. Si tienes acceso a cPanel, mira el “Administrador de Procesos” o “Estado de MySQL” para ver si hay bloqueos.
  4. Si el problema persiste, contacta al soporte del hosting.

2. Errores específicos en cPanel

Aquí tienes las variantes más típicas del mysql connection error cpanel.

2.1 “Access denied for user ‘usuario’@‘localhost’”

Este error significa que el usuario existe pero la contraseña no coincide, o que el usuario no tiene permisos sobre esa base de datos.

Solución paso a paso:

  1. Entra en cPanel → “Bases de datos MySQL”.
  2. Busca la sección “Añadir usuario a la base de datos”.
  3. Asegúrate de que tu usuario está marcado como “TODOS LOS PRIVILEGIOS”.
  4. Haz clic en “Hacer cambios”.
  5. Cambia la contraseña del usuario (sección “Cambiar contraseña”).
  6. Actualiza el archivo wp-config.php o config.inc.php con la nueva contraseña.

2.2 “Unknown database ‘usuariox_bd’”

Este error aparece cuando el nombre de la base de datos no existe o está mal escrito. Sucede mucho al importar una web desde otro hosting.

Solución:

  1. Ve a cPanel → “Bases de datos MySQL”.
  2. Mira la lista de bases de datos existentes.
  3. Si no está, créala con el nombre exacto que indica tu archivo de configuración.
  4. Si ya existe, copia el nombre exacto y pégalo en el archivo de configuración (no lo reescribas).

2.3 Error de conexión después de migrar a cPanel

Al mover una web, la gente olvida que los prefijos cambian. Si tu web venía de otro panel, el nombre mipagina_bd puede ser ahora usuario_mipagina_bd.

[TIP] Usa la herramienta “PHPMyAdmin” de cPanel para verificar que puedes iniciar sesión con esas credenciales manualmente. Si no puedes entrar desde PHPMyAdmin, tu web tampoco podrá.

3. Errores comunes en Plesk

Plesk es más usado en VPS y servidores dedicados. Los errores son similares, pero cambia la interfaz.

3.1 “Connection refused” o “Can’t connect to MySQL server on ‘localhost’ (10061)”

Esto suele indicar que el servicio MySQL no está corriendo, o que el puerto está bloqueado por un firewall.

Solución:

  1. Accede a Plesk → “Herramientas y Ajustes” → “Servicios del servidor”.
  2. Busca “MySQL Server” y verifica que está “corriendo”.
  3. Si está detenido, inícialo.
  4. Si no puedes, entra por SSH y ejecuta: systemctl start mysql (o mariadb).
  5. Revisa si el firewall bloquea el puerto 3306 desde tu IP.

3.2 Plesk error conexion bd: “Client does not support authentication protocol”

Esto pasa cuando PHP (cliente) usa un método de autenticación antiguo y MySQL usa uno nuevo (o viceversa). Es típico tras actualizar PHP.

Solución rápida:

  1. En Plesk, ve a “Ajustes de PHP” y cambia la versión de PHP a una más reciente (8.1, 8.2).
  2. Si el problema persiste, conecta por SSH y ejecuta:
    ALTER USER 'tu_usuario'@'localhost' IDENTIFIED WITH mysql_native_password BY 'tu_clave';
  3. Limpia la caché de Plesk desde “Herramientas y Ajustes” → “Gestor de tareas”.

[WARNING] No cambies el método de autenticación si no sabes qué estás haciendo. Puede romper otras aplicaciones.

4. Errores en DirectAdmin

DirectAdmin es menos común, pero tiene sus propias peculiaridades.

4.1 “MySQL server has gone away”

Este error es típico cuando el paquete de datos es demasiado grande o el servidor tiene un timeout muy bajo. DirectAdmin suele tener configuraciones más estrictas por defecto.

Solución:

  1. Ve a DirectAdmin → “MySQL Management”.
  2. Asegúrate de que la base de datos existe y el usuario tiene permisos.
  3. Si tienes acceso a SSH, edita /etc/my.cnf y aumenta los valores:
    • max_allowed_packet = 128M
    • wait_timeout = 300
  4. Reinicia MySQL: systemctl restart mysql.

4.2 “Table ‘x’ doesn’t exist” en DirectAdmin

A menudo es un problema de caché o de que la tabla se corrompió durante una importación.

Solución:

  1. Entra en PHPMyAdmin desde DirectAdmin.
  2. Selecciona la base de datos y haz clic en “Reparar tabla” (si es MyISAM).
  3. Si es InnoDB, intenta exportar e importar de nuevo.

5. WordPress: “Error establishing a database connection” (el más famoso)

Este error es el rey de los dolores de cabeza. WordPress error establishing database connection aparece cuando el archivo wp-config.php tiene datos incorrectos o el servidor MySQL no responde.

5.1 Solución paso a paso (nivel básico)

  1. Accede por FTP o al administrador de archivos de tu hosting.
  2. Busca el archivo wp-config.php en la raíz de WordPress.
  3. Descárgalo y ábrelo con un editor de texto (Notepad++ o similar).
  4. Busca estas líneas: 
    define('DB_NAME', 'tu_basededatos');
define('DB_USER', 'tu_usuario');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost');
  5. Verifica que cada valor es exactamente el que tienes en cPanel/Plesk/DirectAdmin.
  6. Guarda el archivo y súbelo de nuevo.

5.2 El error de “DB_HOST” en WordPress

A veces localhost no funciona y necesitas usar 127.0.0.1 o el nombre del servidor MySQL que te da tu hosting (ej: mysql.midominio.com).

[TIP] Si tu hosting usa LiteSpeed o CloudLinux, prueba a cambiar localhost por 127.0.0.1. Este simple cambio soluciona el 50% de los casos.

5.3 El error tras mover WordPress a otro hosting

Al migrar, la gente cambia el dominio pero olvida que la base de datos tiene un prefijo diferente. Si tu web venía de un hosting con prefijo wp_ y el nuevo usa miweb_, debes actualizar el archivo wp-config.php.

5.4 ¿Y si el archivo está bien y aun así falla?

  1. Revisa si el servidor MySQL está caído (contacta al hosting).
  2. Desactiva plugins desde la base de datos (en la tabla wp_options, cambia active_plugins a a:0:{}).
  3. Comprueba si el problema es solo en el panel de administración o en toda la web.

6. PrestaShop: “Error de conexión con la base de datos”

Prestashop error conexion base datos suele mostrar un mensaje rojo en la instalación o un error 500 al cargar la tienda.

6.1 Error en la instalación (paso 3 de instalación)

Si estás instalando PrestaShop y falla la conexión, el problema está en los datos que introduces en el asistente.

Solución:

  1. Ve a tu panel de control y crea una base de datos (si no la tienes).
  2. Crea un usuario con todos los privilegios.
  3. En el asistente de PrestaShop, introduce el nombre completo de la BD (con prefijo).
  4. Usa localhost como servidor, salvo que tu hosting indique lo contrario.

6.2 Error después de una actualización de PrestaShop

Al actualizar, el archivo app/config/parameters.php se regenera. Si algo falla, las credenciales se corrompen.

Solución manual:

  1. Accede por FTP a /app/config/.
  2. Abre parameters.php.
  3. Busca los parámetros database_host, database_name, database_user, database_password.
  4. Corrige los valores si son incorrectos.
  5. Borra la carpeta var/cache/ (o cache/ en versiones antiguas) para forzar la regeneración.

6.3 Error de “privilegios insuficientes” en PrestaShop

A veces el usuario de la BD no puede hacer ALTER TABLE o DROP. Esto pasa en hosts muy restrictivos.

Solución:

  1. En cPanel, edita el usuario y marca “TODOS LOS PRIVILEGIOS”.
  2. En Plesk, ve a la base de datos y en la pestaña “Usuarios” selecciona “Acceso total”.
  3. En DirectAdmin, entra en “MySQL Management” y marca todas las casillas.

[WARNING] En algunos hosts, los privilegios se aplican solo a la BD, no al servidor completo. Verifica que estás editando el usuario correcto en la BD correcta.

7. Cómo diagnosticar rápido el error (método infalible)

Si no sabes por dónde empezar, sigue esta secuencia lógica:

  1. Prueba la conexión manualmente con PHPMyAdmin (o el administrador de BD de tu panel). Si no puedes entrar, el problema es de credenciales o del servidor.
  2. Revisa el estado del servicio MySQL en tu panel (si tienes acceso). Si está apagado, no hay nada que hacer hasta que lo enciendan.
  3. Comprueba los logs de error. En cPanel: “Errores de Error Log”. En Plesk: “Logs de Apache”. Busca la palabra “mysql” o “database”.
  4. Desactiva el firewall temporalmente (solo si tienes VPS) para descartar bloqueos de IP.

8. Consejos finales y preguntas frecuentes (FAQ)

¿Por qué me funciona a veces y a veces no?

Suele ser por límite de conexiones. Si tu web recibe muchos visitantes, MySQL puede agotar el máximo de conexiones simultáneas. La solución es aumentar max_connections en el servidor o usar un plugin de caché (como W3 Total Cache o LiteSpeed Cache) para reducir las peticiones.

¿Qué hago si nada de esto funciona?

Si has verificado credenciales, host, puerto, permisos y estado del servidor, el problema puede ser un bloqueo de IP por parte del firewall del hosting. Contacta con soporte y diles que tienes un mysql connection error cpanel o plesk error conexion bd y que ya has descartado todo lo demás.

¿Puedo evitar estos errores en el futuro?

Sí, con estas buenas prácticas:

  • Anota las credenciales en un gestor de contraseñas.
  • No cambies la contraseña de la BD sin actualizar el archivo de configuración.
  • Antes de migrar, exporta la BD y anota el prefijo.
  • Usa siempre localhost salvo que tu hosting diga lo contrario.
  • Actualiza PHP y MySQL a versiones compatibles entre sí.

[INFO] Si usas un panel llamado Syspanel (antes conocido como HestiaCP), recuerda que el acceso al panel se realiza a través del puerto 2106. Los errores de conexión a BD en Syspanel se solucionan igual que en DirectAdmin, ya que usa la misma estructura de archivos de configuración en /home/usuario/web/dominio/public_html/.

Resumen ejecutivo

Los errores conexion base datos no son un misterio. En el 80% de los casos, la solución está en:

  1. Revisar el archivo de configuración (wp-config.php, parameters.php, etc.).
  2. Verificar que las credenciales coinciden con las del panel.
  3. Confirmar que el servidor MySQL está activo.

Con esta guía, podrás resolver el mysql connection error cpanel, el plesk error conexion bd, el wordpress error establishing database connection y el prestashop error conexion base datos sin volverte loco. Recuerda: paciencia, verifica una cosa a la vez y no cambies varias variables simultáneamente, o no sabrás qué solucionó el problema.

Si después de todo sigues atascado, busca en la documentación de tu proveedor o escribe a soporte

¿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