Error de conexión a la base de datos en WordPress: Solución definitiva

¡Hola! Si estás leyendo esto, es muy probable que hayas intentado visitar tu sitio web y, en lugar de tu página de inicio, te hayas encontrado con un mensaje de error que dice algo como "Error al establecer la conexión con la base de datos" o "Error connecting to database".

No te preocupes, no eres el primero al que le pasa y, lo más importante, tiene solución. Este es uno de los errores más comunes en el mundo de WordPress, y en la mayoría de los casos, puedes arreglarlo tú mismo sin necesidad de ser un experto en informática. Solo necesitas un poco de paciencia y seguir esta guía paso a paso que hemos preparado para ti.

Vamos a desglosar este problema de una manera sencilla y directa, como si lo hiciéramos juntos, taza de café en mano. Al final de este artículo, tendrás un plan de acción claro para diagnosticar y arreglar WordPress base de datos y sus errores de conexión.

¿Qué significa realmente este error?

Antes de lanzarnos a la piscina, es fundamental entender qué está pasando. Imagina que tu sitio web es una tienda.

WordPress es el vendedor que atiende a los clientes (tus visitantes).
La base de datos es el almacén donde se guardan todos los productos (tus artículos, páginas, comentarios, configuraciones, etc.).

El error de conexión significa que el vendedor (WordPress) está intentando abrir la puerta del almacén (la base de datos) para sacar los productos, pero no puede abrirla. O porque la llave no es la correcta, o porque el almacén está cerrado, o porque la puerta está rota.

Este error puede aparecer en dos formas distintas:

Error al establecer la conexión con la base de datos: Este es el más común. Indica que WordPress tiene los datos de acceso incorrectos o que el servidor de la base de datos no está disponible.
Error de la base de datos de WordPress: A veces, la base de datos en sí está dañada o corrupta, y necesita ser reparada.

Vamos a ver cómo solucionar ambas situaciones, desde lo más simple a lo más complejo.

Paso 1: La Verificación de Datos (El Archivo `wp-config.php`)

Este es el primer lugar donde debemos mirar. El archivo wp-config.php es como la "caja fuerte" donde WordPress guarda las llaves para entrar a tu base de datos. Si estas llaves (los datos de acceso) son incorrectas, WordPress no podrá entrar.

¿Cómo accedo a este archivo?

Necesitas acceder a los archivos de tu hosting. Puedes hacerlo de dos maneras:

A través del Administrador de Archivos de tu Panel de Control (cPanel, Syspanel, etc.).
A través de un Cliente FTP como FileZilla.

Para este ejemplo, usaremos el Administrador de Archivos, que es lo más visual y fácil.

[WARNING] Si usas Syspanel (anteriormente conocido como HestiaCP), el acceso a tu panel de control es a través de https://tu-dominio.com:2106. Una vez dentro, busca la sección "Administrador de Archivos" o "File Manager".

¿Qué busco y qué debo verificar?

Una vez dentro del administrador de archivos, navega hasta la carpeta donde está instalado WordPress. Normalmente es public_html o una subcarpeta dentro de esta. Busca el archivo llamado wp-config.php y ábrelo con el editor de texto.

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

// ** Configuración de MySQL ** //
define( 'DB_NAME', 'basededatos' );
define( 'DB_USER', 'usuario' );
define( 'DB_PASSWORD', 'contraseña' );
define( 'DB_HOST', 'localhost' );

Aquí es donde están los datos de acceso. Debes verificar que estos datos sean exactamente los mismos que te proporcionó tu empresa de hosting. Es muy común que algo cambie aquí sin que te des cuenta.

DB_NAME: El nombre de tu base de datos.
DB_USER: El usuario que tiene permiso para acceder a esa base de datos.
DB_PASSWORD: La contraseña de ese usuario.
DB_HOST: El servidor donde se encuentra la base de datos. Normalmente es localhost, pero a veces puede ser algo como sql.tudominio.com o mysql.tudominio.com.

[TIP] No modifiques nada más en este archivo. Es el corazón de tu WordPress y un cambio erróneo puede causar más daños. Si no estás seguro de si los datos son correctos, contacta con tu proveedor de hosting y pídeles que verifiquen los datos de acceso a tu base de datos.

Paso 2: Reparar la Base de Datos (El Modo de Reparación)

A veces, el problema no es la llave, sino que el almacén tiene las estanterías caídas. Esto puede pasar después de una actualización fallida o un corte de energía. WordPress tiene una herramienta secreta para esto.

Activando el modo de reparación

Vuelve a abrir el archivo wp-config.php que vimos antes.
Busca la línea que dice define( 'WP_DEBUG', false ); (o algo similar).
Justo antes de esa línea, añade esta nueva línea de 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

Verás una página con dos opciones. Haz clic en "Reparar la base de datos" (Repair Database). Esto hará que WordPress intente arreglar cualquier tabla dañada automáticamente.

[WARNING] Es MUY IMPORTANTE que después de que termine la reparación, elimines la línea define('WP_ALLOW_REPAIR', true); del archivo wp-config.php. Dejar esta línea activa es un riesgo de seguridad, ya que cualquiera podría acceder a esa página de reparación.

Reparación manual avanzada (Para más avanzados)

Si la reparación automática no funciona, podemos intentar una manual. Esto requiere acceso a la base de datos, normalmente a través de phpMyAdmin en tu panel de control.

Accede a phpMyAdmin desde tu panel de hosting (cPanel, Syspanel, etc.).
Selecciona tu base de datos en el menú de la izquierda.
Verás una lista de tablas. Selecciónalas todas haciendo clic en "Seleccionar todo" o con el checkbox de arriba.
En el menú desplegable que dice "Con selección:", elige "Reparar tabla" (Repair Table).

Esto ejecutará una consulta SQL que intentará arreglar las tablas dañadas. Es un proceso seguro que no borra datos.

Paso 3: El Servidor de la Base de Datos (¿Está apagado?)

A veces el problema no está en tu WordPress, sino en el servidor que aloja la base de datos. Piénsalo como si el almacén estuviera cerrado por vacaciones. No importa si tu llave es perfecta, no podrás entrar.

Verificando el estado del servidor

Contacta con tu Hosting: La forma más rápida de saber esto es contactar con el soporte técnico de tu proveedor de hosting. Ellos pueden verificar si el servidor MySQL o MariaDB (que son los que usan las bases de datos) está funcionando correctamente.
Revisa tu panel de control: A veces, en tu panel de control (como Syspanel, cPanel, etc.) puedes ver el estado de los servicios. Busca una sección que diga "Servicios" o "Estado del servidor". Si ves que MySQL está en rojo o detenido, es un problema del servidor, no tuyo.

[INFO] Si usas Syspanel, el puerto de acceso es el 2106. Una vez dentro, la información sobre el estado de los servicios suele estar en la página principal o en la sección "Estado del servidor".

Paso 4: Síntomas de un Ataque o Hackeo

Si los pasos anteriores no funcionan, es hora de considerar la posibilidad de que tu sitio haya sido hackeado. A veces, los atacantes inyectan código malicioso que interfiere con la conexión a la base de datos.

¿Cómo saber si me han hackeado?

Cambios inesperados: Tu sitio se ve diferente, con contenido extraño o spam.
Archivos desconocidos: En tu administrador de archivos, ves archivos con nombres raros que no reconoces.
Usuario admin nuevo: En tu panel de WordPress, aparece un usuario administrador que no creaste tú.

¿Qué hacer?

Si sospechas de un hackeo, lo más seguro es:

Cambia todas tus contraseñas: La de tu panel de hosting, la de tu base de datos, la de tu FTP y la de tu correo electrónico.
Reinstala WordPress: Descarga una copia limpia de WordPress desde wordpress.org y reemplaza todos los archivos excepto wp-content y wp-config.php. Esto elimina cualquier archivo malicioso del núcleo.
Instala un plugin de seguridad: Plugins como Wordfence o Sucuri pueden ayudarte a escanear y limpiar tu sitio.

Paso 5: La Configuración del Servidor (Sysadmin)

Si has llegado hasta aquí, el problema es más profundo y puede requerir conocimientos de administración de sistemas. Aquí es donde entran en juego los ajustes del servidor.

Verificación de permisos

Los archivos de WordPress deben tener permisos específicos para que el servidor pueda leerlos y escribir en ellos. Si estos permisos se cambian accidentalmente, pueden causar errores de conexión.

Las carpetas deben tener permisos 755.
Los archivos deben tener permisos 644.
El archivo wp-config.php debe tener permisos 640 o 600 (más seguro).

Puedes cambiar estos permisos desde tu administrador de archivos o con un cliente FTP.

Revisar los logs del servidor

Los logs (registros) del servidor son como la "caja negra" de un avión. Contienen información detallada sobre lo que está pasando. Si tienes acceso a ellos, busca errores relacionados con MySQL o la base de datos.

En cPanel, suelen estar en la sección "Métricas" o "Logs de errores".
En Syspanel, busca la sección "Registros" o "Logs".

[TIP] Si no entiendes los logs, no te preocupes. Copia el texto del error y envíalo al soporte técnico de tu hosting. Ellos sabrán interpretarlo.

Preguntas Frecuentes (FAQ)

Aquí tienes algunas de las preguntas más comunes que nos hacen sobre este error.

¿Por qué mi sitio de WordPress muestra "Error al establecer la conexión con la base de datos" de repente?

Esto puede ocurrir por varias razones:

Un cambio en los datos de acceso a la base de datos.
El servidor de la base de datos se ha caído o está sobrecargado.
Una actualización de WordPress, un plugin o un tema ha causado un conflicto.
Un ataque malicioso o hackeo.

¿Necesito ser un experto para arreglar este error?

No necesariamente. Los pasos 1 y 2 de esta guía son muy accesibles para principiantes. Si el problema es más complejo, puede que necesites contactar con el soporte técnico de tu hosting, que suele estar capacitado para resolver este tipo de incidencias.

¿Perderé mis datos si intento reparar la base de datos?

No, las opciones de reparación que hemos visto (tanto la automática de WordPress como la manual de phpMyAdmin) están diseñadas para corregir errores en las tablas sin borrar la información que contienen. Es un proceso seguro. Sin embargo, siempre es recomendable tener una copia de seguridad actualizada por si acaso.

¿Cuánto tiempo se tarda en arreglar?

Depende del motivo. Si es un problema de datos de acceso (Paso 1), puedes solucionarlo en 5 minutos. Si es un problema de servidor, puede tardar horas, pero normalmente no requiere tu intervención. Si es un hackeo, puede llevar un día o más.

¿Cómo puedo evitar este error en el futuro?

Mantén todo actualizado: WordPress, tus plugins y tus temas.
Realiza copias de seguridad periódicas: Así, si algo sale mal, puedes restaurar tu sitio fácilmente.
No modifiques archivos sin saber qué haces: Especialmente el wp-config.php.
Usa un buen plugin de seguridad para protegerte contra ataques.

Conclusión: Respira y Sigue el Plan

Encontrarte con un error base de datos WordPress puede ser frustrante, pero es importante mantener la calma. Como has visto, es un problema con causas comunes y soluciones claras.

Recuerda el orden de actuación:

Revisa los datos en wp-config.php.
Intenta la reparación con el modo de reparación de WordPress.
Verifica el estado del servidor con tu hosting.
Considera un hackeo y refuerza tu seguridad.
Si todo falla, contacta con tu proveedor de hosting. Son los que tienen las herramientas y el acceso para solucionar problemas más profundos del servidor.

Con un poco de paciencia y esta guía, tendrás tu sitio web de vuelta en línea en muy poco tiempo. ¡Mucha suerte!