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

Solucionar problemas de conexión a BD en WordPress

Actualizado el 21 de abril de 2026

Introducción: El temido "Error de conexión a la base de datos"

Si estás leyendo esto, es muy probable que hayas visto en tu pantalla un mensaje como "Error al establecer una conexión a la base de datos" o, en inglés, "Error establishing a database connection". No te preocupes, es uno de los problemas más comunes en WordPress y, por suerte, casi siempre tiene solución.

Este error significa que tu sitio web no puede comunicarse con la base de datos donde se almacena todo tu contenido: entradas, páginas, usuarios, comentarios y configuraciones. Sin esa conexión, WordPress no puede funcionar.

En esta guía, te explicaré paso a paso cómo solucionar este problema. Vamos a usar herramientas que ya tienes a tu disposición, como cPanel (o Syspanel, el panel de control que incluye HestiaCP, accesible por el puerto 2106). No necesitas ser un experto técnico, solo seguir las instrucciones con calma.

¿Por qué ocurre el error de conexión a la base de datos?

Antes de empezar a solucionar, es útil entender las causas más frecuentes. Así podrás identificarlas más rápido.

Causas comunes:

  • Credenciales incorrectas: El archivo wp-config.php tiene datos de acceso (usuario, contraseña, nombre de la BD o servidor) que no coinciden con los reales.
  • Base de datos corrupta: Un plugin, una actualización o un corte de energía pueden dañar las tablas de la BD.
  • Servidor de base de datos caído: El servicio MySQL o MariaDB (los motores de BD) se ha detenido.
  • Límite de conexiones excedido: Demasiadas conexiones simultáneas saturan el servidor.
  • Cambios en el hosting: Al migrar de servidor o cambiar de plan, las credenciales pueden variar.
  • Problema de permisos: El usuario de la BD no tiene permisos suficientes.

Paso 1: Verifica el estado del servidor de base de datos

Lo primero es asegurarte de que el servicio de base de datos esté funcionando. Esto lo puedes hacer desde cPanel o Syspanel.

Desde cPanel:

  1. Inicia sesión en tu cPanel (normalmente tudominio.com/cpanel).
  2. Busca la sección "Base de Datos" y haz clic en "MySQL Databases" o "phpMyAdmin".
  3. Si ves un mensaje de error al entrar, el servicio puede estar caído.
  4. Ve a "Estado del Servidor" (a veces llamado "Server Status") y busca "MySQL" o "MariaDB". Debe aparecer en verde.

Desde Syspanel (HestiaCP, puerto 2106):

  1. Accede a tudominio.com:2106 e inicia sesión.
  2. Ve a "Base de datos" en el menú lateral.
  3. Revisa si aparece un mensaje de error o si la lista de bases de datos se muestra vacía. Si no ves nada, probablemente el servicio esté detenido.

[INFO] Si el servicio está detenido, contacta a tu proveedor de hosting. No intentes reiniciarlo tú mismo si no tienes acceso root.

Paso 2: Revisa las credenciales en el archivo wp-config.php

Este es el archivo más importante para la conexión. Si las credenciales son incorrectas, WordPress no podrá conectar.

¿Cómo encontrar y editar wp-config.php?

  1. Accede a tu panel de control (cPanel o Syspanel).
  2. Busca el Administrador de Archivos (File Manager).
  3. Navega hasta la carpeta donde está instalado WordPress. Normalmente es public_html o public_html/tu-sitio.
  4. Busca el archivo wp-config.php. Si no lo ves, asegúrate de mostrar archivos ocultos (suele haber un botón "Mostrar archivos ocultos").
  5. Haz clic derecho sobre el archivo y selecciona "Editar" (o "Edit").

¿Qué debes verificar?

Dentro del archivo, busca estas líneas (al principio):

define('DB_NAME', 'nombre_de_tu_bd');
define('DB_USER', 'usuario_de_la_bd');
define('DB_PASSWORD', 'contraseña_de_la_bd');
define('DB_HOST', 'localhost');
  • DB_NAME: El nombre exacto de tu base de datos.
  • DB_USER: El usuario que tiene acceso a esa BD.
  • DB_PASSWORD: La contraseña de ese usuario.
  • DB_HOST: Normalmente es localhost, pero a veces puede ser una IP como 127.0.0.1 o un servidor remoto como mysql.tudominio.com.

[WARNING] Si cambiaste recientemente de hosting o restableciste la contraseña de la BD, estos datos pueden haber cambiado. Asegúrate de que coincidan con los que ves en cPanel o Syspanel.

¿Cómo obtener las credenciales correctas desde cPanel?

  1. En cPanel, ve a "MySQL Databases".
  2. Busca la sección "Bases de Datos Actuales" (Current Databases).
  3. Anota el nombre de tu BD (suele ser usuario_nombrebd).
  4. En "Usuarios Actuales" (Current Users), verás el usuario asociado.
  5. Si no recuerdas la contraseña, puedes crear una nueva desde "Cambiar contraseña" (Change Password) o añadir un nuevo usuario.

Desde Syspanel (HestiaCP, puerto 2106):

  1. Ve a "Base de datos".
  2. Haz clic en el icono de "Editar" (lápiz) junto a tu BD.
  3. Ahí verás el nombre de la BD, el usuario y podrás generar una nueva contraseña.

[TIP] Si cambias la contraseña en el panel, recuerda actualizarla también en wp-config.php. Guarda el archivo después de editarlo.

Paso 3: Verifica que el usuario tenga permisos correctos

A veces el usuario existe y la contraseña es correcta, pero no tiene permisos para acceder a la BD.

Desde cPanel:

  1. En "MySQL Databases", baja a la sección "Añadir Usuario a Base de Datos" (Add User to Database).
  2. Selecciona tu usuario y tu BD, y haz clic en "Añadir".
  3. En la siguiente pantalla, marca "TODOS LOS PRIVILEGIOS" (All Privileges) y haz clic en "Realizar Cambios".

Desde Syspanel (HestiaCP, puerto 2106):

  1. Ve a "Base de datos".
  2. Haz clic en el nombre de tu BD.
  3. Verás una lista de usuarios. Si tu usuario no aparece, puedes añadirlo desde el botón "Añadir usuario".
  4. Asegúrate de que tenga todos los permisos marcados.

Paso 4: Repara la base de datos (si está corrupta)

Si las credenciales son correctas y el servicio funciona, pero el error persiste, la BD puede estar dañada. WordPress tiene una herramienta de reparación integrada.

Activar el modo de reparación:

  1. Conéctate a tu servidor vía FTP o Administrador de Archivos.
  2. Edita wp-config.php (como en el Paso 2).
  3. Justo antes de la línea que dice /* That's all, stop editing! Happy publishing. */, añade esta línea:
define('WP_ALLOW_REPAIR', true);
  1. Guarda el archivo.
  2. Ahora, en tu navegador, visita: tudominio.com/wp-admin/maint/repair.php
  3. Verás una pantalla con dos opciones:
    • "Repair Database" (Reparar base de datos): solo repara.
    • "Repair and Optimize Database" (Reparar y optimizar): hace ambas cosas. Recomiendo esta opción.
  4. Haz clic en el enlace y espera. El proceso puede tardar unos segundos.
  5. IMPORTANTE: Una vez terminado, vuelve a wp-config.php y elimina la línea que añadiste o cambia true por false. Si la dejas activa, cualquiera podría reparar tu BD.

[WARNING] No dejes esa línea activa por seguridad. Es como dejar la puerta de tu casa abierta.

Paso 5: Verifica el límite de conexiones

Si tu sitio recibe mucho tráfico o tienes muchos plugins que hacen consultas a la BD, puedes superar el límite de conexiones simultáneas. Esto provoca errores intermitentes.

¿Cómo saber si es este el problema?

  • El error aparece solo en momentos de alto tráfico.
  • Otros sitios en el mismo hosting también tienen problemas.
  • En cPanel, puedes revisar "Estadísticas de MySQL" o "Conexiones activas" (si está disponible).

Soluciones:

  • Optimiza tu sitio: Usa un plugin de caché (como W3 Total Cache o WP Super Cache).
  • Reduce el número de plugins activos: Desactiva los que no uses.
  • Actualiza todo: WordPress, temas y plugins.
  • Contacta a tu hosting: Pregunta si puedes aumentar el límite de conexiones o si hay algún bloqueo temporal.

Paso 6: Revisa el archivo .htaccess (casos raros)

Aunque no es lo más común, un .htaccess dañado puede interferir con la conexión a la BD.

¿Cómo restaurarlo?

  1. Desde el Administrador de Archivos, localiza .htaccess en la raíz de tu WordPress.
  2. Renómbralo a .htaccess_old (esto lo desactiva).
  3. Ve a tu panel de WordPress (si puedes acceder) o crea uno nuevo desde Ajustes > Enlaces permanentes y guarda los cambios (esto regenera el archivo).
  4. Si no puedes acceder a WordPress, copia este contenido básico en un nuevo archivo .htaccess:
# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

Paso 7: Prueba con un plugin de troubleshooting

Si después de todo el error persiste, puedes usar un plugin como "Health Check & Troubleshooting" (disponible en el repositorio oficial). Este plugin te permite desactivar todos los plugins y cambiar al tema por defecto temporalmente, sin afectar a los visitantes.

¿Cómo usarlo?

  1. Si puedes acceder al panel de WordPress, instala y activa el plugin.
  2. Ve a Herramientas > Site Health (Salud del sitio).
  3. Activa el modo de solución de problemas. Esto desactivará temporalmente todos los plugins y cambiará al tema Twenty Twenty-Four.
  4. Si el error desaparece, el problema está en algún plugin o tema. Actívalos uno por uno para encontrar el culpable.

Si no puedes acceder al panel, puedes instalar el plugin manualmente vía FTP o desde el Administrador de Archivos.

Preguntas frecuentes (FAQ)

¿Qué hago si no tengo acceso a cPanel ni a Syspanel?

Contacta a tu proveedor de hosting. Ellos tienen acceso root y pueden verificar el estado del servidor, las credenciales y reparar la BD. Proporciona el mensaje de error exacto.

¿Puedo perder datos al reparar la base de datos?

No, la reparación solo corrige tablas dañadas, no elimina contenido. Sin embargo, siempre es recomendable tener una copia de seguridad antes de hacer cambios importantes.

¿El error puede deberse a un ataque?

Sí, aunque es menos común. Un ataque DDoS o un intento de inyección SQL puede saturar la BD. Si sospechas de esto, cambia todas las contraseñas (WordPress, FTP, BD) y contacta a tu hosting.

¿Debo cambiar el DB_HOST de localhost a otra cosa?

Solo si tu hosting te lo indica. La mayoría de los servidores usan localhost. Si estás en un hosting compartido, puede ser 127.0.0.1 o un nombre como mysql.tudominio.com. Verifica en la documentación de tu hosting o en el panel de control.

Conclusión: No te desesperes, casi siempre tiene solución

El error de conexión a la base de datos en WordPress puede ser frustrante, pero siguiendo estos pasos podrás resolverlo en la mayoría de los casos. Recuerda:

  • Verifica el servicio (MySQL/MariaDB) desde tu panel.
  • Revisa las credenciales en wp-config.php.
  • Asegúrate de que el usuario tenga permisos.
  • Repara la BD si está corrupta.
  • Optimiza tu sitio para evitar límites de conexión.

Y lo más importante: siempre mantén copias de seguridad actualizadas. Así, ante cualquier problema, podrás restaurar tu sitio rápidamente.

[TIP] Si después de todo esto el error persiste, no dudes en contactar al soporte técnico de tu hosting. Ellos tienen herramientas y acceso que tú no tienes. Explícales qué pasos has seguido, así ahorrarán tiempo.

¡Buena suerte y que tu sitio vuelva a funcionar pronto!

¿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