Solucionar 'Error de conexión con la base de datos' en WordPress

¡Vaya, qué susto! Estás tranquilo trabajando en tu sitio web, añadiendo una entrada nueva o leyendo los comentarios, y de repente, aparece un mensaje que hiela la sangre: "Error de conexión con la base de datos". No te preocupes, es uno de los fallos más comunes en WordPress y, en la gran mayoría de los casos, tiene una solución sencilla que no requiere ser un experto en informática.

Este error simplemente significa que WordPress no puede comunicarse con tu base de datos, que es donde se guardan todas tus publicaciones, páginas, comentarios y ajustes. Sin esa comunicación, el sitio no puede cargar nada.

Piensa en ello como si intentaras abrir una tienda: la web es el escaparate, pero la base de datos es el almacén donde tienes todos los productos. Si la puerta del almacén está cerrada con llave o la llave no es la correcta, no puedes sacar los productos y mostrarlos en el escaparate.

En esta guía, vamos a desglosar paso a paso cómo solucionar el error conexión base de datos wordpress, tanto si tu hosting usa el panel de control cPanel como si usa Plesk. No importa si es tu primera vez con este problema; aquí te lo explicamos todo de forma clara y sencilla.

¿Por qué ocurre este error?

Antes de lanzarnos a arreglar nada, es útil entender las causas más comunes. Esto te ayudará a identificar la solución más rápida. Las razones principales para un error base de datos wordpress suelen ser:

Datos de acceso incorrectos: La configuración de tu sitio (en el archivo wp-config.php) tiene un nombre de usuario, contraseña o nombre de base de datos que no coincide con los reales.
Servidor de base de datos caído: El servidor MySQL o MariaDB está sobrecargado, en mantenimiento o se ha detenido por un fallo.
Archivos del sitio corruptos: Algún archivo esencial de WordPress se ha dañado o eliminado, impidiendo la conexión correcta.
Problemas de permisos: Los permisos de los archivos en el servidor son demasiado restrictivos o demasiado abiertos, causando conflictos.
Cambios recientes: A veces, mover el sitio a un nuevo servidor o cambiar la contraseña de la base de datos sin actualizar wp-config.php provoca este problema.

Vamos a atacar el problema por fases, de lo más simple a lo más complejo. La idea es que no toques nada que no necesites.

Fase 1: Verifica el Estado del Servidor (Lo Primero)

A veces, el problema no es tuyo, sino de tu proveedor de hosting. Antes de tocar archivos, haz una comprobación rápida.

Pasos a seguir:

Revisa tu correo electrónico: Muchos proveedores de hosting envían avisos sobre mantenimiento programado o incidencias en sus servidores. Revisa la bandeja de entrada (y la de spam) de la cuenta asociada a tu dominio.
Intenta acceder a tu panel de control: Entra a tu cPanel o Plesk. Si el panel de control carga correctamente, significa que el servidor web está activo. Ahora busca la sección de "Base de Datos MySQL" o "phpMyAdmin".
Prueba phpMyAdmin: Intenta entrar a phpMyAdmin (desde cPanel o Plesk). Si esta herramienta carga y puedes ver tus bases de datos, el servidor de bases de datos está funcionando. Si no carga o da error, el problema es del servidor y deberás contactar con tu proveedor de hosting, indicándoles que tienes un error conexión mysql wordpress y que crees que el servidor de bases de datos está caído.

[INFO] Si phpMyAdmin no carga, el problema está fuera de tu alcance. No pierdas el tiempo intentando arreglar el código. Contacta con el soporte de tu hosting y diles que crees que el servicio de MySQL está caído. Ellos deberían poder solucionarlo en minutos.

Fase 2: Revisar el Archivo `wp-config.php` (La Causa Más Común)

Si el servidor funciona, el siguiente sospechoso es el archivo wp-config.php. Este archivo es el "directorio de contactos" de WordPress; contiene la información clave para conectarse a la base de datos.

¿Cómo acceder al archivo?

Tienes dos formas de hacerlo:

A través del cPanel o Plesk (Administrador de archivos): Esta es la forma más segura y la que recomendamos.
A través de un cliente FTP (como FileZilla): Si te sientes cómodo con FTP.

Usando el Administrador de Archivos (cPanel):

Entra a tu cPanel.
Busca la sección "Archivos" y haz clic en "Administrador de archivos".
Navega hasta la carpeta public_html (o httpdocs si usas Plesk). Si tu WordPress está en una subcarpeta (por ejemplo, public_html/miweb), navega hasta allí.
Busca el archivo llamado wp-config.php. No lo abras directamente, haz clic derecho sobre él y selecciona "Editar" o "Code Editor".

Usando el Administrador de Archivos (Plesk):

Entra a tu Plesk.
Ve a "Sitios web y dominios".
Haz clic en "Administrador de archivos" en el dominio correspondiente.
Accede a la carpeta httpdocs o la que corresponda.
Igual que en cPanel, busca el archivo wp-config.php y edítalo con el editor de texto.

¿Qué buscar y corregir?

Una vez que tengas el editor abierto, verás varias líneas de código PHP. Busca las que empiezan con define( y contienen información sobre la base de datos. Son estas:

// ** Configuración de MySQL ** //
define( 'DB_NAME', 'nombre_de_tu_base_de_datos' );
define( 'DB_USER', 'nombre_de_usuario' );
define( 'DB_PASSWORD', 'tu_contraseña' );
define( 'DB_HOST', 'localhost' );

Aquí es donde está el 80% de los problemas. Debes asegurarte de que estos cuatro datos son exactamente los correctos.

DB_NAME: Este es el nombre exacto de tu base de datos. En cPanel, normalmente tiene un prefijo con tu nombre de usuario (ej. usuario123_wpdb). En Plesk, suele ser el nombre del dominio o algo similar (ej. mibasededatos).
DB_USER: El nombre de usuario de la base de datos. También suele tener un prefijo en cPanel (ej. usuario123_wpadmin).
DB_PASSWORD: La contraseña de ese usuario. ¡Ojo aquí! Si hace poco la cambiaste, este archivo no se actualiza solo. Debes poner la contraseña nueva.
DB_HOST: Este es un punto crítico. Normalmente es localhost, pero a veces los proveedores usan una dirección distinta como mysql.tudominio.com o localhost:3306.

[WARNING] No corrijas los datos "a ojo". Si no estás seguro del nombre exacto de tu base de datos o usuario, ve a la sección "Bases de datos MySQL" en tu cPanel o Plesk y cópialos directamente desde allí. Un simple punto o guion bajo mal puesto puede mantener el error.

¿Cómo obtener los datos correctos en cPanel?

Ve a la sección "Bases de datos" y haz clic en "Bases de datos MySQL".
Verás una lista con todas tus bases de datos y sus usuarios. Compara los nombres con los que tienes en wp-config.php.
Si no recuerdas la contraseña, puedes cambiarla desde el mismo cPanel. Haz clic en "Cambiar contraseña" junto al usuario de la base de datos. Pon una contraseña nueva y segura, y luego actualiza wp-config.php con esa nueva contraseña.

¿Cómo obtener los datos correctos en Plesk?

Ve a "Sitios web y dominios" y busca la sección "Bases de datos" o el icono de "Bases de datos MySQL".
Ahí verás el nombre de la base de datos y el usuario asociado.
Para cambiar la contraseña, entra en la base de datos específica y busca la opción de cambiar la contraseña del usuario.

Una vez que hayas corregido los datos, guarda el archivo y recarga tu sitio web. Si el error persiste, continúa con la siguiente fase.

Fase 3: Reparar la Base de Datos (Si Está Dañada)

A veces, la base de datos en sí está funcionando, pero algunas de sus tablas están dañadas o corruptas, lo que impide que WordPress la lea correctamente. WordPress tiene una herramienta de reparación integrada, pero está desactivada por defecto.

Activando el modo de reparación:

Vamos a activar una función oculta de WordPress. No te asustes, es un proceso muy sencillo y reversible.

Accede de nuevo a tu wp-config.php con el editor de archivos.
Busca la línea que dice ¡Eso es todo, deja de editar! Feliz blogging. (o similar en inglés).
Justo antes de esa línea, pega el siguiente código:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo.
Ahora, en tu navegador, ve a esta dirección: www.tudominio.com/wp-admin/maint/repair.php

Deberías ver una página con dos opciones: "Reparar base de datos" y "Reparar y optimizar base de datos". Haz clic en la primera.

WordPress intentará reparar las tablas dañadas. Verás una lista de resultados.
Cuando termine, es muy importante que borres la línea que añadiste en el paso 3. Deja el archivo wp-config.php como estaba antes. Si no lo haces, cualquier persona podría acceder a esa página de reparación y causar problemas.

[WARNING] No dejes la línea define('WP_ALLOW_REPAIR', true); en tu archivo. Es una puerta de seguridad abierta. Actívala solo para reparar y desactívala inmediatamente después.

Fase 4: Revisar los Permisos de Archivos y Carpetas

Los permisos de archivos en tu servidor son como las llaves de las puertas. Si están mal configurados, WordPress puede tener problemas para leer los archivos necesarios, lo que a veces se manifiesta como un error de conexión.

¿Qué permisos deben tener?

Carpetas: 755 (o 750 en algunos servidores).
Archivos: 644 (o 640 en algunos servidores).
El archivo wp-config.php: Se recomienda que tenga permisos 600 o 640 por seguridad, pero 644 también suele funcionar.

¿Cómo cambiar los permisos en cPanel?

Ve al "Administrador de archivos".
Navega hasta la raíz de tu WordPress (por ejemplo, public_html).
Selecciona todos los archivos y carpetas (Ctrl+A o Cmd+A).
Haz clic en "Permisos" en la barra de herramientas superior.
Se abrirá una ventana. Marca la casilla "Cambiar recursivamente".
Pon los valores: 755 para carpetas y 644 para archivos. La forma más fácil es poner 755 en el campo de permisos numérico y marcar "Cambiar recursivamente", pero esto hará que los archivos también tengan 755. Lo ideal es hacerlo en dos pasos:
- Primero, selecciona solo las carpetas y ponles 755.
- Luego, selecciona solo los archivos y ponles 644.

Es un poco tedioso, pero es efectivo. En Plesk, el proceso es similar dentro del "Administrador de archivos", haciendo clic en el archivo o carpeta y seleccionando "Cambiar permisos".

Fase 5: Soluciones Avanzadas (Para Cuando Nada de lo Anterior Funciona)

Si has llegado hasta aquí y el error conexión base de datos wordpress sigue apareciendo, puede que el problema sea más específico. No te rindas, aún hay esperanza.

1. Comprobar el prefijo de las tablas

En tu wp-config.php, hay una línea que dice:

$table_prefix = 'wp_';

Asegúrate de que el prefijo (en este caso wp_) coincide con el prefijo real de tus tablas en la base de datos. Puedes verlo en phpMyAdmin. Si tu base de datos usa un prefijo diferente (ej. miweb_), debes cambiarlo en el archivo de configuración.

2. Revisar los logs de error

Los logs de error son archivos donde el servidor guarda información sobre los fallos. Son una mina de oro para diagnosticar problemas.

En cPanel: Busca la sección "Métricas" y haz clic en "Errores" o "Error log". Ahí verás los errores recientes. Busca líneas que mencionen "database" o "mysql".
En Plesk: Ve a "Sitios web y dominios" y busca el icono de "Logs" o "Registros". Ahí puedes ver los logs de error del sitio.

Busca mensajes como Access denied for user '...'@'...' (que indica un problema de contraseña) o Unknown database '...' (que indica que el nombre de la base de datos es incorrecto). Estos te darán pistas exactas.

3. Restaurar desde una copia de seguridad

Si el problema es que un archivo se ha corrompido y no puedes identificar cuál, la opción más drástica pero efectiva es restaurar tu sitio desde una copia de seguridad reciente.

Desde cPanel: Busca la sección "Archivos" y luego "Copias de seguridad" o "Backup". Ahí puedes restaurar la copia de seguridad del directorio public_html y de la base de datos.
Desde Plesk: Ve a "Sitios web y dominios" y busca la opción "Copias de seguridad" o "Backup Manager".

Si tu proveedor de hosting ofrece copias de seguridad automáticas, puedes pedirles que restauren la última copia diaria. Esta es una solución muy común y efectiva para el error base de datos wordpress.

4. Contactar con tu proveedor de hosting

Si nada de esto funciona, ha llegado el momento de llamar a los profesionales. Contacta con el soporte técnico de tu hosting. Diles exactamente qué has hecho y qué errores ves. Ellos tienen acceso a herramientas más avanzadas y podrán diagnosticar el problema en el servidor.

[TIP] Cuando contactes con el soporte, ten a mano esta información: tu nombre de dominio, la fecha y hora en que empezó el error, y cualquier mensaje de error exacto que hayas visto (tanto en la pantalla como en los logs). Esto acelerará mucho el proceso de soporte.

Preguntas Frecuentes (FAQ) Rápidas

Para terminar, aquí tienes algunas respuestas a preguntas comunes sobre este tema.

¿Qué es `wp-config.php`?

Es el archivo de configuración principal de WordPress. Contiene la información vital para que tu sitio se conecte a la base de datos, así como otras opciones de configuración y seguridad.

¿Por qué mi hosting usa `localhost` como `DB_HOST`?

En la mayoría de los servidores compartidos, la base de datos y el sitio web están en la misma máquina, por lo que localhost es la dirección correcta. Algunos proveedores utilizan una dirección diferente por motivos de seguridad o arquitectura.

¿Cambiar la contraseña de la base de datos en cPanel/Plesk soluciona el error?

Solo si el problema es que la contraseña en wp-config.php es incorrecta. Si cambias la contraseña en el panel de control, debes actualizarla también en wp-config.php inmediatamente, o el error persistirá.

¿Qué es Syspanel?

Syspanel es un panel de control de hosting (similar a cPanel o Plesk) que algunas empresas utilizan. Si tu hosting usa Syspanel, el puerto de acceso es el 2106 (por ejemplo, https://tudominio.com:2106). Los pasos para gestionar archivos y bases de datos son muy similares a los de cPanel: busca las secciones de "Administ