Error de conexión a base de datos en WordPress: Soluciones

¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto, seguramente te has topado con el temido mensaje de "Error al establecer una conexión a la base de datos" en tu sitio 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 muy visual, vamos a desglosar paso a paso cómo diagnosticar y solucionar el error de conexión a base de datos en WordPress. Te prometo que al final del artículo, si sigues los pasos, tendrás tu web funcionando de nuevo.

Vamos a empezar desde lo más básico hasta lo más técnico, pero siempre explicado para que lo entiendas aunque no seas un experto.

¿Qué significa exactamente este error?

Cuando tu sitio WordPress muestra el mensaje "Error al establecer una conexión a la base de datos", significa que WordPress (el programa que gestiona tu web) no puede hablar con la base de datos donde se almacenan todas tus entradas, páginas, usuarios, comentarios y configuraciones. Sin esa conexión, tu web no puede mostrar nada.

Piensa en ello como una biblioteca: WordPress es el bibliotecario y la base de datos es el almacén de libros. Si el bibliotecario no puede entrar al almacén, no puede prestarte ningún libro. El error puede deberse a muchas causas, desde un simple cambio de contraseña hasta un fallo del servidor. Vamos a ver cómo arreglar wp-config.php y otras causas comunes.

## Causa 1: El archivo wp-config.php está mal configurado

El archivo wp-config.php es el "mapa" que le dice a WordPress dónde está la base de datos y cómo acceder a ella. Si este archivo tiene datos incorrectos, la conexión falla.

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

Accede a tu hosting: Necesitas un programa FTP (como FileZilla) o el administrador de archivos de tu panel de control (como cPanel, Plesk o Syspanel). Recuerda que Syspanel se accede por el puerto 2106 (ejemplo: tudominio.com:2106).
Busca la carpeta raíz: Normalmente se llama public_html o www. Ahí dentro está tu instalación de WordPress.
Encuentra el archivo: Busca el archivo llamado wp-config.php. Si no lo ves, puede que esté oculto. Activa la opción "Mostrar archivos ocultos" en tu cliente FTP.
Descárgalo o ábrelo: Haz una copia de seguridad descargándolo a tu PC. Luego, ábrelo con un editor de texto plano (como Notepad++, Sublime Text o el bloc de notas). No uses Word o Pages, ya que pueden añadir formato extraño.

### ¿Qué datos revisar?

Dentro del archivo, busca estas líneas (normalmente están al principio):

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');

DB_NAME: El nombre exacto de tu base de datos.
DB_USER: El nombre de usuario que tiene acceso a esa base de datos.
DB_PASSWORD: La contraseña de ese usuario.
DB_HOST: Casi siempre es localhost, pero algunos hostings usan una dirección como mysql.tudominio.com.

[WARNING] ¡Cuidado! No cambies nada más que estos valores. Un error en una coma o una comilla puede romper tu web.

### ¿Cómo obtener los datos correctos?

Desde tu panel de hosting (cPanel, Syspanel, etc.): Busca la sección "Bases de datos MySQL" o "MySQL Databases". Allí verás listadas todas tus bases de datos y los usuarios asociados.
Si usas Syspanel: Ve a la sección "Bases de datos". Allí podrás ver el nombre de la base, el usuario y, si no recuerdas la contraseña, puedes crear una nueva (y luego actualizar wp-config.php con esa nueva contraseña).

[TIP] Si cambias la contraseña en el panel, debes actualizarla también en wp-config.php. Es un error muy común olvidarse de hacerlo.

## Causa 2: El servidor de bases de datos (MySQL) está caído o sobrecargado

A veces el problema no está en tu configuración, sino en el servidor que aloja tu base de datos. Esto es más común en hosting compartido, donde varios sitios comparten recursos.

### ¿Cómo saber si es un problema del servidor?

Prueba con otra web: Si tienes otros sitios en el mismo hosting, revisa si también fallan. Si todos fallan, es muy probable que sea un problema general del servidor.
Revisa el estado del servicio: Algunos hostings tienen un panel de estado (status.tuhosting.com). También puedes preguntar en el soporte técnico.
Usa un plugin de caché: A veces el servidor MySQL se "cuelga" por un pico de visitas. Un buen plugin de caché (como W3 Total Cache o WP Super Minify) puede reducir la carga y evitar estos cortes.

[INFO] Si el problema es del servidor, la solución suele ser esperar a que el equipo de hosting lo reinicie o lo solucione. No hay mucho que puedas hacer desde tu lado, salvo reportarlo.

## Causa 3: El usuario de la base de datos no tiene permisos

Aunque el nombre de usuario y la contraseña sean correctos, si ese usuario no tiene permisos para acceder a la base de datos, WordPress no podrá conectarse.

### ¿Cómo verificar y asignar permisos?

Accede a la sección de bases de datos de tu panel de hosting.
Busca la opción "Añadir usuario a base de datos" o "Manage User Privileges".
Selecciona el usuario y la base de datos correctos.
Marca todos los privilegios (normalmente hay un botón "Select All" o "Todos los privilegios"). Los más importantes son: SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP.
Guarda los cambios.

[TIP] En Syspanel, esta opción está en la sección "Bases de datos" > "Editar" junto a la base de datos. Allí puedes gestionar los usuarios y sus permisos.

## Causa 4: Corrupción en la base de datos

A veces la base de datos se daña por un cierre incorrecto, un plugin defectuoso o un ataque. WordPress tiene una herramienta para repararla.

### Cómo reparar la base de datos automáticamente

Añade una línea a wp-config.php: Abre el archivo wp-config.php y, justo antes de la línea que dice /* That's all, stop editing! Happy blogging. */, añade esta línea:
```
define('WP_ALLOW_REPAIR', true);
```
Accede a la herramienta de reparación: Abre tu navegador y ve a esta dirección (reemplaza tudominio.com con tu dominio):

tudominio.com/wp-admin/maint/repair.php

Verás una página con dos botones:
- "Reparar base de datos" (intenta arreglar los problemas).
- "Reparar y optimizar base de datos" (además de reparar, limpia y optimiza las tablas).
Ejecuta la opción que prefieras. Normalmente con "Reparar" es suficiente.
¡Importante! Una vez terminado, vuelve a wp-config.php y elimina la línea que añadiste. Si la dejas, cualquiera podría reparar tu base de datos sin permiso, lo cual es un riesgo de seguridad.

## Causa 5: Problemas con el prefijo de las tablas

Por defecto, las tablas de WordPress empiezan con wp_. Si por alguna razón cambiaste este prefijo (por seguridad) o tu hosting lo hizo, el archivo wp-config.php debe reflejarlo.

### ¿Dónde se define el prefijo?

En wp-config.php, busca esta línea:

$table_prefix = 'wp_';

Asegúrate de que el valor entre comillas coincida con el prefijo real de tus tablas en la base de datos. Puedes verificar esto accediendo a phpMyAdmin (desde tu panel de hosting) y mirando los nombres de las tablas.

## Causa 6: El servidor de base de datos usa un puerto no estándar

Aunque lo más común es que DB_HOST sea localhost, algunos hostings usan un puerto diferente, como localhost:3307 o una dirección IP específica.

### ¿Cómo saber si es este el caso?

Consulta la documentación de tu hosting o pregunta al soporte técnico. Ellos te dirán el valor exacto que debes poner en DB_HOST. Por ejemplo, si te dicen que el servidor MySQL está en mysql.tudominio.com en el puerto 3307, deberías escribir:

define('DB_HOST', 'mysql.tudominio.com:3307');

## Causa 7: El plugin de seguridad o caché bloquea la conexión

Algunos plugins de seguridad muy agresivos o de caché mal configurados pueden interferir con la conexión a la base de datos.

### ¿Cómo probar esto?

Desactiva todos los plugins: La forma más rápida es renombrar la carpeta plugins dentro de wp-content. Conéctate por FTP, ve a wp-content, cambia el nombre de la carpeta plugins a plugins_old. Esto desactivará todos los plugins.
Revisa tu web: Si el error desaparece, el problema era un plugin. Ahora, vuelve a renombrar la carpeta a plugins y ve activando los plugins de uno en uno desde el panel de administración (si puedes acceder) o renombrando carpetas dentro de plugins para activarlos manualmente, hasta encontrar el culpable.
Si no puedes acceder al panel: Otra opción es desde phpMyAdmin, en la tabla wp_options, buscar la fila active_plugins y borrar su contenido (esto desactivará todos los plugins).

## Causa 8: El archivo .htaccess está corrupto

A veces, el archivo .htaccess (que controla las reglas de reescritura y redirecciones) se daña y provoca conflictos.

### Solución rápida

Conéctate por FTP a la raíz de tu WordPress.
Renombra el archivo .htaccess a .htaccess_old.
Prueba tu web. Si funciona, el problema era ese archivo.
Genera uno nuevo: Ve a tu panel de WordPress (Ajustes > Enlaces permanentes) y haz clic en "Guardar cambios". Esto creará un nuevo .htaccess limpio.

## Preguntas Frecuentes (FAQ)

### ¿Por qué aparece este error después de cambiar la contraseña de la base de datos?

Porque olvidaste actualizar la contraseña en el archivo wp-config.php. Es el error más común. Sigue los pasos de la Causa 1 para actualizarla.

### ¿Puedo perder mis datos si la base de datos está dañada?

No necesariamente. La herramienta de reparación de WordPress (Causa 4) suele arreglar la mayoría de los problemas sin pérdida de datos. Siempre es recomendable tener una copia de seguridad reciente.

### Mi web muestra el error pero el panel de administración (wp-admin) funciona. ¿Qué pasa?

Esto es menos común, pero puede ocurrir si el problema está en un plugin o tema que solo afecta a la parte pública. Prueba a desactivar plugins y cambiar a un tema por defecto (Twenty Twenty-Four) desde el panel.

### ¿Qué hago si nada de esto funciona?

Si has seguido todos los pasos y el error persiste, el problema es seguramente del servidor. Contacta con el soporte técnico de tu hosting. Diles que has verificado el wp-config.php, los permisos y que has intentado reparar la base de datos. Ellos podrán revisar los logs del servidor MySQL para encontrar la causa exacta.

## Resumen rápido: Lista de verificación

Revisa wp-config.php: Datos correctos (nombre, usuario, contraseña, host).
Verifica permisos del usuario: En la base de datos.
Repara la base de datos: Usando WP_ALLOW_REPAIR.
Desactiva plugins: Renombrando la carpeta plugins.
Renombra .htaccess: Para descartar reglas corruptas.
Contacta al soporte: Si todo lo demás falla.

Espero que esta guía te haya sido de gran ayuda. Recuerda que la paciencia es clave. El error de conexión a la base de datos en WordPress es frustrante, pero casi siempre tiene una solución sencilla. Si te ha funcionado alguno de estos métodos, ¡genial! Si no, no dudes en escribirme de nuevo. ¡Buena suerte con tu web!