Resolver error de conexión a base de datos en WordPress: Guía

¡Hola! Soy el técnico de soporte de tu hosting. Si has llegado hasta aquí, probablemente te has encontrado con el temido mensaje de Error al establecer una conexión a la base de datos en tu WordPress. No te preocupes, es uno de los errores más comunes y, por suerte, casi siempre tiene solución. En esta guía extensa y fácil de seguir, vamos a desglosar paso a paso cómo diagnosticar y solucionar el error conexión base de datos WordPress.

Vamos a empezar desde lo más básico. Este error significa que WordPress no puede comunicarse con el motor de base de datos (normalmente MySQL o MariaDB) donde se almacenan todas tus publicaciones, usuarios, comentarios y configuraciones. Sin esa conexión, tu web no puede cargar nada. Pero respira hondo; en la mayoría de los casos, la solución es sencilla y no requiere ser un experto en programación.

¿Por qué aparece este error?

Antes de lanzarnos a las soluciones, es útil entender las causas más comunes. El error conexión base de datos WordPress suele deberse a una de estas cinco razones:

Credenciales incorrectas en el archivo wp-config.php. Es la causa más frecuente. WordPress necesita un nombre de usuario, contraseña, nombre de base de datos y servidor para conectarse. Si alguno de estos datos está mal, la conexión falla.
La base de datos está corrupta o dañada. Aunque es menos común, puede ocurrir tras una migración fallida, un plugin defectuoso o un corte de energía durante una actualización.
El servidor de base de datos está caído o sobrecargado. A veces, el problema no está en tu web, sino en el servidor que aloja la base de datos. Esto puede ocurrir por mantenimiento, un pico de tráfico o una falla técnica.
Problemas con el prefijo de la base de datos. Si has cambiado el prefijo (por ejemplo, de wp_ a miweb_) y no lo has hecho correctamente, WordPress no encontrará las tablas.
El archivo wp-config.php está dañado o mal configurado. Un error al editar este archivo (como una línea mal escrita) puede romper la conexión.

Ahora, vamos a solucionar error WordPress paso a paso. Sigue el orden que te propongo, ya que va de lo más simple a lo más complejo.

Paso 1: Verificar el estado del servidor (lo más rápido)

Antes de tocar nada, asegúrate de que el problema no sea general. A veces, el servidor de base de datos de tu hosting está en mantenimiento o ha tenido un fallo temporal.

¿Cómo comprobarlo?

Accede a tu panel de control. Si tu hosting usa Syspanel (el panel de control que antes se conocía como HestiaCP), recuerda que la URL de acceso suele ser https://tudominio.com:2106. Inicia sesión con tus credenciales.
Busca el estado de los servicios. Dentro de Syspanel, normalmente hay una sección de "Servicios" o "Estado del servidor". Busca indicadores como "MySQL" o "MariaDB". Si están en rojo o aparecen como "Detenido", el problema está ahí.
Reinicia el servicio. Si tienes permisos (normalmente los administradores del servidor), puedes intentar reiniciar el servicio de base de datos. En Syspanel, suele haber un botón de "Reiniciar" junto al servicio. Haz clic y espera unos segundos.
Prueba otra web. Si tienes otras webs en el mismo hosting, comprueba si también muestran el error. Si es así, el problema es del servidor y deberás contactar con el soporte técnico de tu hosting.

[TIP] Si el servicio de base de datos está caído, pero no puedes reiniciarlo desde Syspanel, contacta con el soporte de tu hosting. Ellos pueden hacerlo en segundos.

Paso 2: Revisar el archivo wp-config.php (el corazón de la conexión)

Este es el archivo más importante para la conexión. Contiene las credenciales exactas que WordPress utiliza. Un error aquí es la causa número 1 del error conexión base de datos WordPress.

¿Cómo acceder y editarlo?

Accede a tu hosting por FTP o por el Administrador de Archivos.
- Por FTP: Usa un cliente como FileZilla. Conéctate con tu usuario y contraseña de FTP (los encuentras en tu panel de control, normalmente en la sección "Cuentas FTP").
- Por Administrador de Archivos: Desde tu panel de control (Syspanel u otro), busca la opción "Administrador de Archivos" o "File Manager". Normalmente está en la sección "Web" o "Archivos".
Navega hasta la raíz de tu WordPress. Busca la carpeta public_html (o la carpeta donde tengas instalado WordPress). Allí encontrarás el archivo wp-config.php.
Descarga una copia de seguridad. Antes de editarlo, descarga el archivo a tu ordenador. Así, si algo sale mal, puedes restaurarlo.
Abre el archivo con un editor de texto plano. No uses Word o Pages. Usa el Bloc de Notas (Windows), TextEdit (Mac en modo texto plano) o un editor de código como Notepad++ o Sublime Text.
Busca las siguientes líneas:

define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'usuario_de_la_base_de_datos');
define('DB_PASSWORD', 'contraseña_de_la_base_de_datos');
define('DB_HOST', 'localhost');

¿Qué debes comprobar?

DB_NAME: El nombre de la base de datos. Debe coincidir exactamente con el que ves en tu panel de control (por ejemplo, en Syspanel, en la sección "Bases de Datos").
DB_USER: El usuario de la base de datos. A menudo es el mismo que el nombre de la base de datos o un usuario específico.
DB_PASSWORD: La contraseña de ese usuario. Es sensible a mayúsculas y minúsculas. Si la has cambiado recientemente, este es el lugar para actualizarla.
DB_HOST: Normalmente es localhost, pero algunos hostings usan direcciones como mysql.tudominio.com o 127.0.0.1. Si has cambiado de hosting o servidor, este valor puede haber cambiado.

[WARNING] Si no estás seguro de las credenciales, no adivines. Ve al paso siguiente para obtenerlas desde tu panel de control.

[INFO] A veces, el archivo wp-config.php también contiene una línea como define('WP_ALLOW_REPAIR', true);. Si está, es para reparar la base de datos. La veremos más adelante.

Paso 3: Obtener las credenciales correctas desde tu panel de control

Si sospechas que las credenciales son incorrectas, lo mejor es crearlas de nuevo o consultarlas desde tu panel. Te explico cómo hacerlo en Syspanel.

En Syspanel (puerto 2106):

Accede a https://tudominio.com:2106 e inicia sesión.
Busca la sección "Bases de Datos" o "Base de Datos". Allí verás una lista de tus bases de datos.
Haz clic en el nombre de la base de datos de tu WordPress. Se abrirá una ventana con los detalles.
Verás el Nombre de la base de datos, el Usuario y un botón para Mostrar contraseña o Cambiar contraseña.
Si no recuerdas la contraseña, cámbiala por una nueva (segura) y anótala.
Ahora, edita tu archivo wp-config.php con estos datos exactos.

[TIP] Si tienes varias bases de datos, asegúrate de estar editando la correcta. El nombre de la base de datos suele ser algo como usuario_wordpress.

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

A veces, la base de datos se corrompe ligeramente. WordPress tiene una función oculta para repararla.

Método 1: Añadiendo una línea al wp-config.php

Abre tu archivo wp-config.php (como en el Paso 2).
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);

Guarda el archivo y súbelo de nuevo al servidor (si lo editaste localmente).
Ahora, en tu navegador, visita: https://tudominio.com/wp-admin/maint/repair.php
Verás una pantalla con dos opciones:
- Reparar base de datos: Intenta arreglar los problemas.
- Reparar y optimizar base de datos: Además de reparar, optimiza las tablas (esto puede tardar un poco más).
Haz clic en "Reparar base de datos" primero. Espera a que termine. Te mostrará un mensaje de éxito o te indicará si hubo errores.
IMPORTANTE: Una vez terminado, borra la línea que añadiste (define('WP_ALLOW_REPAIR', true);) del archivo wp-config.php. Dejarla activa es un riesgo de seguridad, ya que cualquiera podría intentar reparar tu base de datos.

Método 2: Usando phpMyAdmin (desde tu panel de control)

Accede a tu panel de control (Syspanel, puerto 2106).
Busca "phpMyAdmin" o "Base de datos -> phpMyAdmin".
Selecciona la base de datos de tu WordPress (verás una lista de tablas a la izquierda).
Marca la casilla de "Seleccionar todo" (suele estar al final de la lista de tablas).
En el menú desplegable "Con seleccionados", elige "Reparar tabla".
phpMyAdmin ejecutará la reparación y te mostrará los resultados.

Paso 5: Verificar el prefijo de la base de datos

Si alguna vez cambiaste el prefijo de las tablas de WordPress (por seguridad) y lo hiciste mal, la conexión fallará.

Revisa tu archivo wp-config.php. Busca la línea:

$table_prefix = 'wp_';

El valor entre comillas (por ejemplo, wp_) es el prefijo.
Ahora, accede a tu base de datos por phpMyAdmin (como en el Paso 4, Método 2).
Mira la lista de tablas. Deberían llamarse algo como wp_posts, wp_options, etc. Si el prefijo en tu archivo wp-config.php es diferente al de las tablas (por ejemplo, tu archivo dice miweb_ pero las tablas son wp_), entonces ese es el problema.
Solución: Cambia el prefijo en el archivo wp-config.php para que coincida con el de las tablas reales.

[WARNING] No cambies el prefijo de las tablas directamente en phpMyAdmin a menos que sepas exactamente lo que haces. Es más seguro y sencillo editar el archivo wp-config.php.

Paso 6: Comprobar problemas con plugins o temas (modo seguro)

A veces, un plugin o tema defectuoso puede interferir con la conexión a la base de datos, aunque es menos común. Para descartarlo, podemos forzar a WordPress a usar un tema por defecto y desactivar los plugins.

¿Cómo hacerlo sin acceso al panel de administración?

Accede por FTP o Administrador de Archivos (como en el Paso 2).
Desactivar todos los plugins:
- Navega a la carpeta wp-content.
- Busca la carpeta plugins y cámbiale el nombre a algo como plugins_desactivados.
- WordPress, al no encontrar la carpeta plugins, asumirá que no hay ninguno activo.
Restaurar un tema por defecto (Twenty Twenty-Four, Twenty Twenty-Three, etc.):
- Dentro de wp-content, busca la carpeta themes.
- Busca la carpeta de tu tema actual (el que está activo). Cámbiale el nombre temporalmente (por ejemplo, añadiendo _old al final).
- WordPress, al no encontrar tu tema, usará uno de los temas por defecto que vienen instalados (como "Twenty Twenty-Four").
Prueba tu web. Si el error desaparece, el problema era un plugin o tu tema. Ahora, ve renombrando las carpetas de plugins de una en una (de plugins_desactivados a plugins) para identificar cuál causaba el conflicto. Cuando lo encuentres, elimínalo o busca una alternativa.

Paso 7: Contactar con el soporte técnico

Si después de todos estos pasos el error conexión base de datos WordPress persiste, es hora de pedir ayuda profesional. El problema podría ser más profundo, como:

Un error en la configuración del servidor.
Un problema de permisos en los archivos.
Un ataque de malware que ha modificado archivos críticos.
Un límite de recursos del servidor (memoria, conexiones simultáneas).

¿Qué información debes proporcionar al soporte?

Para que te ayuden rápido, ten a mano:

El mensaje de error exacto. ¿Es "Error al establecer una conexión a la base de datos" o "Una o más tablas de la base de datos no están disponibles"?
Los pasos que ya has seguido. Diles que ya revisaste el wp-config.php, reparaste la base de datos y desactivaste plugins.
Capturas de pantalla (si es posible) de lo que ves en tu panel de control o en el error.
Tu nombre de usuario y dominio para que puedan localizar tu cuenta rápidamente.

FAQ: Preguntas frecuentes sobre el error de conexión

¿Por qué mi WordPress muestra "Error de conexión a la base de datos" después de mover mi web a un nuevo hosting?

Es muy común. Lo más probable es que las credenciales en tu archivo wp-config.php sigan siendo las del hosting anterior. Actualiza el DB_NAME, DB_USER, DB_PASSWORD y DB_HOST con los datos de tu nuevo hosting. El DB_HOST suele ser localhost, pero algunos hostings usan una dirección específica (revisa el correo de bienvenida de tu nuevo hosting).

¿Qué hago si no puedo acceder ni al panel de administración de WordPress?

No te preocupes. Todos los pasos de esta guía se pueden realizar sin acceso al panel de administración. Usa el FTP o el Administrador de Archivos de tu panel de control (Syspanel, cPanel, etc.) para editar archivos y acceder a phpMyAdmin para reparar la base de datos.

¿Es seguro añadir `define('WP_ALLOW_REPAIR', true);` al wp-config.php?

Sí, es seguro solo mientras lo estás usando. Una vez que hayas reparado la base de datos, debes eliminar esa línea inmediatamente. Si la dejas, cualquier persona que conozca la URL de reparación (/wp-admin/maint/repair.php) podría intentar modificar tu base de datos, aunque no tenga permisos de administrador. Es un riesgo de seguridad evitable.

¿Puedo perder datos si reparo la base de datos?

Reparar la base de datos es un proceso seguro que intenta corregir errores en las tablas sin borrar información. Sin embargo, siempre es recomendable hacer una copia de seguridad antes de cualquier operación importante. La mayoría de los paneles de control (incluyendo Syspanel) tienen una opción para exportar la base de datos desde phpMyAdmin.

¿El error puede deberse a un ataque de hackers?

Sí, es posible. Un atacante podría modificar tu archivo wp-config.php o dañar la base de datos. Si después de seguir todos los pasos el error persiste, y especialmente si notas otros comportamientos extraños (redirecciones, contenido extraño, etc.), contacta con el soporte de tu hosting para que revisen si hay malware.

Resumen final: No te rindas

El error conexión base de datos WordPress es frustrante, pero en el 90% de los casos se resuelve revisando el archivo wp-config.php o reparando la base de datos. Recuerda el orden lógico:

Verifica el servidor (