Reparar base de datos WordPress: Guía con WP-CLI y phpMyAdmin

¿Tu WordPress muestra el temido mensaje de "Error al establecer una conexión con la base de datos"? No entres en pánico. Este es uno de los fallos más comunes, pero también uno de los más fáciles de solucionar si sabes cómo hacerlo.

En esta guía extensa y paso a paso, vamos a explicarte cómo reparar una base de datos WordPress usando dos métodos infalibles: WP-CLI (la herramienta de línea de comandos) y phpMyAdmin (el gestor gráfico que encontrarás en tu panel de control).

No necesitas ser un experto en programación. Solo sigue las instrucciones al pie de la letra y, en menos de 15 minutos, tu web volverá a funcionar.

¿Por qué se daña una base de datos WordPress?

Antes de ponernos manos a la obra, es importante entender qué ha pasado.

Una base de datos (como la de WordPress) está formada por tablas. Cada tabla almacena información específica: entradas, comentarios, usuarios, opciones de configuración, etc.

Con el tiempo, o por culpa de un corte de luz, un plugin mal configurado o un ataque informático, estas tablas pueden "corromperse". Esto significa que la información interna se desordena o se pierde parte de su estructura.

Los síntomas más comunes son:

El sitio muestra un error de conexión a la base de datos.
Aparecen mensajes como "One or more database tables are unavailable".
Las páginas cargan lentísimo o en blanco.
Errores al intentar iniciar sesión en el panel de administración.

La buena noticia es que WordPress incluye una función de "reparación" que intenta arreglar estas tablas automáticamente. Solo tenemos que activarla.

Método 1: Reparar base de datos WordPress con WP-CLI (Recomendado)

WP-CLI es una herramienta de línea de comandos que te permite gestionar tu WordPress sin necesidad de navegador. Es la forma más rápida y segura de reparar la base de datos, ya que no depende de interfaces gráficas que puedan fallar.

Requisitos previos

Acceso a tu servidor por SSH (para conectarte por línea de comandos). Si no sabes qué es esto, normalmente lo encuentras en tu panel de control de Hosting o en el servicio de soporte de tu proveedor.
Tener WP-CLI instalado. En la mayoría de los Hostings modernos (como los que usan Syspanel), ya viene preinstalado.

Paso 1: Conectarte por SSH

Abre tu terminal (en Windows puedes usar PowerShell o CMD, en Mac o Linux la terminal nativa).

Escribe el siguiente comando sustituyendo usuario y tu-dominio.com por tus datos reales:

ssh usuario@tu-dominio.com

Te pedirá tu contraseña. Escríbela y pulsa Enter.

Paso 2: Navegar a la raíz de WordPress

Una vez dentro, debes ir a la carpeta donde está instalado WordPress. Normalmente es public_html o html.

cd public_html

Si no estás seguro, puedes usar el comando ls para listar los archivos y ver si encuentras wp-config.php.

Paso 3: Ejecutar el comando de reparación

Este es el paso clave. Ejecuta el siguiente comando:

wp db repair

Este comando le dice a WP-CLI que revise todas las tablas de tu base de datos y ejecute la reparación automática.

Verás un resultado similar a este:

Success: Database repaired.

O si hay errores específicos, te indicará qué tablas fallaron. En ese caso, puedes intentar reparar una tabla concreta así:

wp db repair wp_options

Paso 4: Optimizar (Opcional pero recomendado)

Después de reparar, es buena práctica optimizar la base de datos. Esto elimina fragmentos de datos basura y mejora el rendimiento.

wp db optimize

¿Por qué usar WP-CLI?

Es mucho más rápido que cualquier método gráfico.
No se queda bloqueado a mitad del proceso.
Puedes automatizarlo con scripts.
Es el método que usamos los técnicos de soporte.

Método 2: Reparar con phpMyAdmin (Para usuarios visuales)

Si no te sientes cómodo con la línea de comandos, no te preocupes. phpMyAdmin es una interfaz web que te permite gestionar tu base de datos con clics. Es perfecto para quienes prefieren ver las cosas.

Paso 1: Acceder a phpMyAdmin

Inicia sesión en el panel de control de tu Hosting. Si usas Syspanel (recuerda, el puerto de acceso es el 2106), busca el icono de phpMyAdmin en el área de "Bases de Datos".
Si no lo encuentras, normalmente puedes acceder directamente desde la URL de tu dominio: https://tu-dominio.com/phpmyadmin o https://tu-dominio.com:2083/3rdparty/phpMyAdmin/index.php (esto varía según el proveedor).
Inicia sesión con el usuario y contraseña de tu base de datos. No uses el usuario de tu cuenta de Hosting, sino el que creaste específicamente para MySQL. Lo encontrarás en el correo de bienvenida de tu Hosting o en el panel de control.

Paso 2: Seleccionar tu base de datos

En el panel izquierdo, verás una lista de bases de datos. Haz clic en el nombre de la que usa tu WordPress.

Importante: Asegúrate de elegir la correcta. Si tienes varias webs, cada una tendrá su propia base de datos.

Paso 3: Marcar todas las tablas

Una vez dentro de tu base de datos, verás una lista de tablas (wp_posts, wp_options, wp_users, etc.).

Al final de la lista, hay un enlace que dice "Marcar todos" o un checkbox en la cabecera de la tabla para seleccionarlas todas. Haz clic en él.
Verás que se activa un menú desplegable en la parte inferior de la lista.

Paso 4: Elegir la opción "Reparar tabla"

En el menú desplegable, selecciona la opción que dice "Reparar tabla" (o "Repair table" si está en inglés).
Haz clic en el botón "Continuar" o "Go".

Paso 5: Esperar el resultado

phpMyAdmin ejecutará el proceso de reparación. Verás una tabla con el estado de cada tabla de tu base de datos.

OK: La tabla se reparó correctamente.
Error: Si alguna falla, te mostrará un mensaje de error específico. En ese caso, repite el proceso solo con esa tabla o intenta exportar e importar los datos (un método avanzado que veremos más adelante).

Alternativa: Reparar una sola tabla

Si solo un plugin o una funcionalidad está fallando, puedes reparar solo la tabla afectada.

Haz clic en el nombre de la tabla (ej. wp_options).
Ve a la pestaña "Operaciones".
Busca la sección "Mantenimiento de tablas".
Haz clic en el botón "Reparar tabla".

Este método es más quirúrgico y suele ser suficiente en la mayoría de los casos.

Método Extra: Activar la reparación automática desde wp-config.php

Existe una tercera vía, muy útil si no puedes acceder ni a WP-CLI ni a phpMyAdmin porque tu web está completamente caída. Este método consiste en añadir una línea de código a tu archivo de configuración.

Paso 1: Acceder a los archivos

Usa el Administrador de Archivos de tu Hosting (en Syspanel lo encuentras en el menú principal).
O conéctate por FTP (FileZilla, por ejemplo).

Paso 2: Editar wp-config.php

Busca el archivo wp-config.php en la raíz de tu instalación de WordPress.
Ábrelo con el editor de texto del panel o con un editor externo.
Busca la línea que dice:
```
/* Eso es todo, ¡diviértete! */
```
Justo antes de esa línea, añade esta otra:
```
define('WP_ALLOW_REPAIR', true);
```
Guarda el archivo y súbelo de nuevo si lo editaste localmente.

Paso 3: Ejecutar el script de reparación

Abre tu navegador y ve a esta URL (sustituye tu-dominio.com):
```
https://tu-dominio.com/wp-admin/maint/repair.php
```
Verás una pantalla con dos opciones:
- Reparar base de datos: Revisa y arregla los problemas.
- Reparar y optimizar base de datos: Hace lo anterior y además limpia la base de datos.
Haz clic en el botón correspondiente y espera.

Paso 4: Desactivar el script (¡CRÍTICO!)

Este paso es obligatorio. No puedes dejar ese script activo, ya que es un agujero de seguridad enorme. Cualquiera podría acceder a tu base de datos y dañarla.

Vuelve a editar wp-config.php.
Elimina la línea que añadiste.
Guarda el archivo.

¿Qué hago si la reparación no funciona?

Si has probado los métodos anteriores y el error persiste, es hora de pasar a un plan B.

1. Exportar e importar la base de datos

Esto es como "reiniciar" la base de datos. A veces, la estructura está tan dañada que la reparación automática no es suficiente.

En phpMyAdmin, selecciona tu base de datos.
Ve a la pestaña "Exportar".
Elige el método "Rápido" y formato "SQL".
Descarga el archivo .sql.
Ahora, elimina todas las tablas de la base de datos (en la lista, márcalas todas y elige "Eliminar").
Ve a la pestaña "Importar", selecciona el archivo que descargaste y sube.
Espera a que termine la importación.

Recomendación: Antes de hacer esto, haz una copia de seguridad del archivo .sql en tu ordenador. Si algo sale mal, siempre podrás restaurarlo.

2. Reparar desde el panel de control del Hosting

Algunos paneles como Syspanel (puerto 2106) incluyen una herramienta de reparación de bases de datos integrada.

Inicia sesión en tu panel.
Busca la sección de "Bases de datos" o "MySQL".
Junto a tu base de datos, puede haber un botón o enlace que diga "Reparar" o "Repair".
Haz clic y sigue las instrucciones.

3. Contactar con el soporte técnico

Si nada de esto funciona, el problema puede ser más profundo (hardware del servidor, corrupción de archivos del sistema, etc.). Contacta con el soporte de tu Hosting.

Pro tip: Cuando contactes, diles que ya has probado WP-CLI y phpMyAdmin. Así se ahorrarán preguntas y te darán una solución más directa.

Preguntas Frecuentes (FAQ)

¿Con qué frecuencia debo reparar mi base de datos?

No es necesario hacerlo a diario. Con hacerlo una vez al mes o cada dos meses es suficiente como mantenimiento preventivo. La clave está en optimizar (no solo reparar) para mantenerla ligera.

¿Perderé mis datos si reparo la base de datos?

No. La reparación solo intenta arreglar la estructura interna de las tablas. No borra contenido. Es un proceso seguro. (Aunque siempre es recomendable tener una copia de seguridad por si acaso).

¿Qué es mejor, WP-CLI o phpMyAdmin?

WP-CLI es más potente y rápido, ideal si estás cómodo con la terminal. phpMyAdmin es más visual y fácil de entender para principiantes. Ambos hacen lo mismo.

¿Puedo reparar la base de datos sin acceso al panel de administración?

Sí, de hecho, es lo normal. Los métodos que te he enseñado (SSH, phpMyAdmin y el archivo wp-config.php) no requieren que WordPress esté funcionando correctamente.

¿El error "Error al establecer una conexión con la base de datos" siempre se arregla con esto?

No siempre. A veces, el error se debe a que las credenciales de la base de datos en wp-config.php son incorrectas (por ejemplo, si cambiaste la contraseña en phpMyAdmin). En ese caso, debes actualizar los datos en ese archivo. Pero si las credenciales son correctas y falla, entonces sí, la reparación suele ser la solución.

¿Qué hago si veo "Table 'wp_options' doesn't exist"?

Esto significa que la tabla se ha eliminado o nunca se creó. La solución es importar una copia de seguridad o, si no tienes, puedes intentar recrearla usando el método de "Exportar/Importar" que mencioné antes. Si no tienes copia, contacta con soporte.

Consejos finales para evitar futuros errores

Realiza copias de seguridad periódicas. Es la mejor medicina. Programa copias automáticas desde tu panel de Hosting o usa un plugin.
Actualiza WordPress, plugins y temas. Las actualizaciones corrigen errores de compatibilidad que pueden dañar la base de datos.
Elimina plugins que no uses. Cada plugin añade tablas y consultas a tu base de datos. Menos es más.
Usa un Hosting de calidad. Un servidor con buenos recursos y estabilidad reduce drásticamente los cortes de energía que corrompen las tablas.

Reparar una base de datos de WordPress es una tarea de mantenimiento básico que, una vez que sabes cómo hacerla, te quitará el miedo a los errores críticos.

Ahora que has llegado hasta aquí, ya tienes el conocimiento y las herramientas. No dudes en guardar esta guía para cuando la necesites.

Si tienes alguna duda, déjala en los comentarios y te ayudaremos a resolverla. ¡Buena suerte con tu WordPress!