Arreglar error de conexión a la base de datos en WordPress

¡Hola! Si has llegado hasta aquí, probablemente te has encontrado con uno de los errores más temidos (y comunes) del mundo WordPress: “Error al conectar con la base de datos”.

No te preocupes, respira hondo. Este mensaje no significa que hayas perdido tu web o tu contenido. Simplemente indica que WordPress no puede comunicarse con la base de datos donde se almacenan tus artículos, páginas y configuraciones. Es como si intentaras abrir una tienda pero la puerta del almacén estuviera cerrada con llave.

En esta guía extensa y paso a paso, vamos a desglosar todas las causas posibles y, lo más importante, cómo solucionarlas. No necesitas ser un experto técnico; solo sigue las instrucciones en orden y, con un poco de paciencia, tu web volverá a estar en línea.

Vamos a ello.

¿Qué significa exactamente este error de base de datos?

Antes de empezar a tocar nada, es crucial entender qué está pasando. WordPress utiliza MySQL (o MariaDB) para guardar toda la información de tu sitio. Cuando visitas tu web, WordPress intenta "hablar" con esa base de datos para traer el contenido. Si falla la conexión, verás el mensaje de error.

Este error puede aparecer de dos formas:

Error simple: “Error al conectar con la base de datos”.
Error con más detalles: “Error establishing a database connection” (en inglés) o un mensaje que dice que no se pudo seleccionar la base de datos.

Ambos significan lo mismo, pero el segundo suele darnos pistas más concretas sobre si el problema es de credenciales (usuario/contraseña) o de que la base de datos no existe.

Importante: No entres en pánico. Tus archivos y entradas siguen ahí. Solo necesitamos restablecer la comunicación.

Paso 1: La solución rápida (y a veces mágica) – Reiniciar

Suena obvio, pero en el mundo del hosting, la mayoría de los problemas se solucionan con un reinicio del servicio. La base de datos puede estar saturada o bloqueada temporalmente.

Si tienes acceso a un panel de control como Syspanel (recuerda que el puerto de acceso es el 2106), cPanel o Plesk, busca la opción de "Reiniciar" o "Restart" para el servicio de MySQL o MariaDB.

¿Cómo hacerlo en Syspanel?

Accede a tu panel Syspanel escribiendo tu-dominio.com:2106 en tu navegador.
Inicia sesión con tus credenciales de administrador.
Busca la sección de "Servicios" o "Estado del servidor".
Localiza el servicio de MySQL o MariaDB y haz clic en el botón de reiniciar.

[TIP] Si no encuentras esta opción, contacta con tu proveedor de hosting. Ellos pueden reiniciar el servicio en segundos desde su lado.

Si después de reiniciar el error persiste, pasa al siguiente paso.

Paso 2: Revisar el archivo wp-config.php (La causa más común)

En el 90% de los casos, este error se debe a que los datos de acceso a la base de datos en el archivo de configuración de WordPress son incorrectos. Esto puede pasar después de migrar la web, cambiar la contraseña de la base de datos o incluso por un error al editar el archivo.

El archivo wp-config.php se encuentra en la raíz de tu instalación de WordPress. Es el "cerebro" que le dice a WordPress cómo conectarse a la base de datos.

¿Cómo editar este archivo?

Necesitas acceso al administrador de archivos de tu hosting (vía Syspanel, cPanel, FTP o SFTP).

Accede al administrador de archivos de tu hosting.
Navega hasta la carpeta donde está instalado WordPress (normalmente public_html o htdocs).
Busca el archivo llamado wp-config.php.
Ábrelo con un editor de texto (no con un procesador de textos como Word).

Dentro del archivo, verás líneas de código como estas:

// ** Ajustes de MySQL ** //
define( 'DB_NAME', 'nombre_de_tu_base' );
define( 'DB_USER', 'usuario_de_tu_base' );
define( 'DB_PASSWORD', 'contraseña_de_tu_base' );
define( 'DB_HOST', 'localhost' );

Aquí es donde debes prestar atención. Verifica que estos cuatro valores sean exactamente los correctos.

DB_NAME: El nombre exacto de tu base de datos.
DB_USER: El usuario que tiene permisos para acceder a esa base.
DB_PASSWORD: La contraseña de ese usuario (¡cuidado con espacios o caracteres invisibles!).
DB_HOST: Normalmente es localhost, pero a veces los hosts usan direcciones como mysql.tudominio.com o localhost:3306.

¿Dónde encuentro estos datos?

Si no los recuerdas, ve a tu panel de Syspanel (puerto 2106) o al panel que uses. Busca la sección de "Bases de datos MySQL". Allí verás una lista con los nombres de las bases y los usuarios. Puedes verificar o cambiar la contraseña desde ahí.

[WARNING] Si cambias la contraseña en el panel, debes actualizarla también en el archivo wp-config.php. Si no lo haces, el error seguirá ahí.

Paso 3: Comprobar que la base de datos existe

A veces, el error no es de contraseña, sino que la base de datos ha sido eliminada por error o no se ha importado correctamente en una migración.

Vuelve a tu panel de control de hosting (Syspanel puerto 2106) y entra en el gestor de bases de datos (phpMyAdmin es el más común). Si no sabes cómo abrirlo, busca un icono que diga "phpMyAdmin".

Una vez dentro, verás una lista de bases de datos a la izquierda. Busca el nombre que tienes en tu wp-config.php en el campo DB_NAME.

Si la base no aparece: Esa es la causa del error. Deberás crearla o restaurarla desde una copia de seguridad.
Si la base aparece: Haz clic en ella y verás un montón de tablas (wp_posts, wp_options, etc.). Si no hay tablas o la lista está vacía, significa que tu base de datos está vacía y WordPress no puede funcionar. También necesitarás restaurarla.

[INFO] Si no tienes una copia de seguridad, contacta con tu proveedor de hosting inmediatamente. Ellos suelen tener copias de seguridad diarias y pueden restaurarla por ti.

Paso 4: Reparar la base de datos (Modo de Reparación)

WordPress tiene una función oculta para reparar bases de datos corruptas. Es muy útil si el error viene acompañado de mensajes como "Una o más tablas de la base de datos no están disponibles".

Para activarla, debes añadir una línea de código a tu archivo wp-config.php, justo antes de la línea que dice /* That's all, stop editing! Happy publishing. */.

define('WP_ALLOW_REPAIR', true);

Guarda el archivo y luego visita en tu navegador: tudominio.com/wp-admin/maint/repair.php.

Verás una página que te ofrece dos opciones:

Reparar base de datos: Revisa y corrige errores menores.
Reparar y optimizar base de datos: Hace lo anterior y además optimiza las tablas.

Haz clic en el botón de Reparar base de datos. Espera a que termine. Después, ELIMINA INMEDIATAMENTE la línea que añadiste al wp-config.php. Es un riesgo de seguridad dejar esa puerta abierta.

[WARNING] Después de reparar, borra la línea define('WP_ALLOW_REPAIR', true); o cualquier persona podría reparar (y potencialmente dañar) tu base de datos sin permiso.

Paso 5: Verificar el prefijo de las tablas

Este es un error menos común pero muy confuso. Cuando migras una web, a veces el prefijo de las tablas cambia. En tu archivo wp-config.php hay una línea que dice:

$table_prefix = 'wp_';

Esto significa que tus tablas se llaman wp_posts, wp_options, etc. Si en tu base de datos las tablas se llaman miweb_posts, miweb_options, etc., entonces el prefijo es miweb_.

Revisa en phpMyAdmin cómo se llaman tus tablas. Si empiezan con algo diferente a wp_, tendrás que cambiar el valor en la línea $table_prefix por el prefijo correcto.

Paso 6: El problema del Hosting (Servidor)

Si has llegado hasta aquí y nada funciona, el problema puede ser del servidor en sí. No es tu culpa. Puede que el servidor de bases de datos esté caído, esté bloqueando la IP de tu web o haya un problema de permisos.

Contacta con tu proveedor: Llama o abre un ticket de soporte. Explícales que tienes el error "Error al conectar con la base de datos" y que ya has verificado tus credenciales y la existencia de la base.
Revisa el correo: A veces, las empresas de hosting envían correos informando de caídas del servidor o mantenimientos programados.

[TIP] Si tu web está en un hosting compartido, es muy probable que un vecino con una web muy pesada esté saturando el servidor. A veces, cambiar de plan o de servidor es la única solución definitiva.

Paso 7: Restaurar desde una copia de seguridad

Si todo lo anterior falla y no puedes arreglar la conexión, la solución más segura es restaurar tu web desde una copia de seguridad reciente.

Descarga la copia: Ve a tu panel de hosting (Syspanel puerto 2106) y busca la sección de "Copias de seguridad" o "Backups". Descarga la más reciente.
Restaura la base de datos: En phpMyAdmin, importa el archivo .sql de la copia de seguridad. Esto sobrescribirá los datos actuales por los de la copia.
Restaura los archivos: Si la copia incluye archivos, sobrescribe todos los archivos de WordPress en tu servidor con los de la copia.

[WARNING] Este paso borrará cualquier cambio que hayas hecho desde la fecha de la copia de seguridad. Es el último recurso, pero es mejor perder un día de cambios que perder toda la web.

Preguntas Frecuentes (FAQ) sobre el error de conexión

Para terminar, resolvamos algunas dudas rápidas que suelen tener los usuarios.

¿Por qué me sale este error después de cambiar la contraseña del hosting?

Es muy común. Si cambias la contraseña de la base de datos desde el panel, el archivo wp-config.php sigue teniendo la antigua. Debes actualizar la línea DB_PASSWORD con la nueva contraseña.

¿Qué significa "Host" en la configuración?

El "Host" es la dirección del servidor donde vive tu base de datos. Para la mayoría de hosts es localhost, pero si tu web está en un servidor externo, puede ser una URL compleja. Esta información siempre la proporciona tu empresa de hosting.

¿Puedo arreglar este error sin acceso al panel de administración de WordPress?

Sí, absolutamente. Todo lo que hemos visto se hace desde el panel de control del hosting (como Syspanel) o vía FTP, no desde el escritorio de WordPress.

Si veo el error en una página en blanco, ¿qué hago?

A veces el error aparece sin formato, en una página blanca con solo texto. El proceso de solución es el mismo. No te dejes intimidar por la falta de diseño.

¿Un plugin puede causar este error?

Es raro, pero un plugin de caché mal configurado o un plugin que modifique la conexión a la base de datos podría causar problemas. Si el error empezó justo después de instalar un plugin, intenta desactivarlo renombrando la carpeta del plugin en el servidor (por ejemplo, cambia wp-content/plugins/mi-plugin a wp-content/plugins/mi-plugin-desactivado).

Conclusión: Recupera el control

El error al conectar con la base de datos es un problema serio pero casi siempre solucionable. La clave está en la calma y el método.

Recapitulando los pasos:

Reinicia el servicio MySQL.
Verifica las credenciales en wp-config.php.
Confirma que la base de datos existe y tiene tablas.
Usa el modo de reparación de WordPress.
Revisa el prefijo de las tablas.
Contacta con tu hosting si todo falla.
Restaura desde un backup como último recurso.

Con esta guía, tendrás todas las herramientas para diagnosticar y arreglar el error bd wordpress. Recuerda que la prevención es mejor que la cura: realiza copias de seguridad periódicas de tu web y de tu base de datos.

Esperamos que este artículo te haya sido de gran ayuda. Si tienes más dudas, déjalas en los comentarios y estaremos encantados de ayudarte a arreglar wordpress y volver a tener tu web funcionando. ¡Mucha suerte!