Reparar Base de Datos WordPress: WP-CLI y phpMyAdmin

¿Te ha aparecido el temido error de conexión a la base de datos en tu WordPress? No entres en pánico. Esto es más común de lo que crees y, en la gran mayoría de los casos, tiene solución rápida.

Una base de datos dañada o con tablas corruptas provoca errores que van desde pantallas en blanco hasta avisos como "Error establishing a database connection" o "One or more database tables are unavailable". La buena noticia es que WordPress incluye herramientas para reparar base de datos wordpress de forma automática o manual.

En esta guía extensa y paso a paso, voy a explicarte, en un lenguaje claro y sin tecnicismos innecesarios, cómo arreglar tu base de datos usando dos métodos principales: WP-CLI (la línea de comandos) y phpMyAdmin (la interfaz gráfica de tu panel de control). No necesitas ser un genio de la programación; solo sigue las instrucciones al pie de la letra.

¿Por qué se dañan las tablas de WordPress?

Antes de meternos en faena, es útil entender el origen del problema. Las tablas de tu base de datos son como los archivos de un armario: si se desordenan o se corrompen, todo el sistema falla.

Las causas más frecuentes de tablas dañadas wordpress incluyen:

Interrupciones del servidor: Un corte de luz o un reinicio brusco del hosting mientras se escribía información.
Errores de software: Plugins o temas mal codificados que realizan consultas incorrectas a la base de datos.
Ataques externos: Intentos de inyección SQL o malware que alteran la estructura de las tablas.
Espacio en disco insuficiente: Si el servidor no tiene espacio, las operaciones de escritura fallan y corrompen los datos.
Actualizaciones fallidas: Tanto de WordPress como de plugins, que no se completan correctamente.

Identificar el error es el primer paso. Si ves mensajes raros en tu panel de administración o directamente no puedes acceder, es hora de actuar.

Método 1: Reparar con WP-CLI (La vía rápida y profesional)

WP-CLI es una herramienta de línea de comandos que te permite gestionar tu WordPress sin usar el navegador. Es el método favorito de los desarrolladores porque es rápido, fiable y no requiere depender de la interfaz web (que es justo lo que está fallando).

¿Cómo accedo a la línea de comandos? Necesitas acceso SSH (Secure Shell) a tu servidor. Si usas un hosting compartido, es posible que no lo tengas. Si tienes un VPS o un servidor dedicado, o si tu proveedor lo ofrece, podrás hacerlo.

Para conectarte, usa un programa como Terminal (en Mac/Linux) o PuTTY (en Windows). Te pedirá tu usuario y contraseña del servidor.

Paso 1: Verificar el estado de las tablas

Una vez conectado por SSH, navega hasta la carpeta raíz de tu instalación de WordPress. Normalmente es algo como public_html, www o html. El comando para cambiar de directorio es cd:

cd public_html

Ahora, para comprobar si las tablas están dañadas, ejecuta este comando:

wp db check

Este comando revisa todas las tablas de tu base de datos y te muestra un informe. Si todo está bien, verás un mensaje de éxito. Si hay errores, te dirá qué tablas tienen problemas.

Paso 2: Reparar las tablas dañadas

WP-CLI tiene un comando específico para wp-cli reparar base de datos. Es tan sencillo como escribir:

wp db repair

Este comando ejecutará la instrucción REPAIR TABLE de MySQL en todas las tablas que lo necesiten. Es un proceso no destructivo, es decir, no borrará ningún dato. Solo intenta reconstruir y arreglar las estructuras dañadas.

[TIP] Si quieres ser más específico y solo reparar una tabla concreta que sabes que está fallando, puedes usar el comando así:

wp db query "REPAIR TABLE nombre_de_tu_tabla;"

Sustituye nombre_de_tu_tabla por el nombre real, por ejemplo, wp_posts.

Paso 3: Optimizar la base de datos (Opcional pero recomendado)

Después de reparar, es buena práctica optimizar las tablas. Esto reorganiza el espacio físico de los datos y puede mejorar el rendimiento. El comando es:

wp db optimize

Este proceso es seguro y también no destructivo. Es como desfragmentar el disco duro de tu ordenador.

[WARNING] Si tu hosting no tiene WP-CLI instalado, verás un mensaje de error como "The wp-cli command not found". En ese caso, tendrás que usar el Método 2 con phpMyAdmin.

Método 2: Reparar con phpMyAdmin (La vía gráfica)

Si no tienes acceso por SSH o te sientes más cómodo con una interfaz visual, phpMyAdmin es tu mejor aliado. Es la herramienta estándar que viene con casi todos los paneles de control de hosting, como cPanel, Plesk o Syspanel.

Para acceder a phpMyAdmin, normalmente buscas el icono en el panel de control de tu hosting. Por ejemplo, en Syspanel (accediendo por el puerto 2106, por ejemplo https://tu-servidor:2106), encontrarás el acceso directo a "Bases de Datos" o "phpMyAdmin".

Paso 1: Seleccionar tu base de datos

Una vez dentro de phpMyAdmin, verás una lista de bases de datos en el panel izquierdo. Haz clic en el nombre de la base de datos que corresponde a tu WordPress. Si no sabes cuál es, revisa el archivo wp-config.php en la raíz de tu instalación; ahí está el nombre en la línea DB_NAME.

Paso 2: Marcar todas las tablas

Después de entrar en tu base de datos, verás una lista de tablas (wp_posts, wp_options, wp_users, etc.). En la parte inferior de la lista, hay una opción para "Marcar" o "Seleccionar todo". Haz clic en esa opción.

Paso 3: Elegir la acción de reparación

Con las tablas marcadas, busca el menú desplegable que dice "Con selección:" (o similar). Despliega el menú y selecciona la opción "Reparar tabla".

[INFO] No confundas "Reparar" con "Optimizar". La reparación corrige errores; la optimización reorganiza el espacio. Puedes hacer ambas, pero primero repara y luego optimiza si lo deseas.

Paso 4: Ejecutar y verificar

Al hacer clic en "Reparar tabla", phpMyAdmin ejecutará el comando SQL y te mostrará una tabla con los resultados. Verás el estado de cada tabla: "OK" si se reparó correctamente, o un mensaje de error si no fue posible.

[WARNING] Si alguna tabla no se puede reparar, es posible que esté muy dañada o que haya un problema de permisos. En ese caso, te recomiendo contactar con el soporte técnico de tu hosting. Si usas Syspanel, su soporte suele ser muy ágil.

Solución automática: El archivo wp-config.php

WordPress tiene una función oculta muy útil para reparar base de datos wordpress de forma automática. Solo tienes que añadir una línea a tu archivo de configuración.

Paso 1: Editar wp-config.php

Accede a tus archivos por FTP (FileZilla, por ejemplo) o por el administrador de archivos de tu panel (en Syspanel, puedes hacerlo desde el puerto 2106). Busca el archivo wp-config.php en la raíz de tu WordPress.

Paso 2: Añadir la constante de reparación

Abre el archivo con un editor de texto (como el Bloc de notas) y 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);

Paso 3: Acceder a la URL de reparación

Guarda el archivo y súbelo de nuevo si lo has editado en local. Ahora, en tu navegador, visita esta dirección:

https://tu-dominio.com/wp-admin/maint/repair.php

Verás una página con dos opciones: "Reparar base de datos" y "Reparar y optimizar la base de datos". Haz clic en la primera (o en la segunda si también quieres optimizar). WordPress hará el trabajo sucio.

Paso 4: ¡MUY IMPORTANTE! Eliminar la línea

Después de que termine la reparación, debes eliminar la línea que añadiste al wp-config.php y subir el archivo de nuevo. Si no lo haces, cualquier persona podría acceder a esa URL y ejecutar reparaciones en tu base de datos, lo cual es un riesgo de seguridad grave.

[WARNING] Este método automático es muy potente, pero puede no funcionar si el error es tan grave que WordPress no puede conectarse a la base de datos en absoluto. En ese caso, usa WP-CLI o phpMyAdmin.

¿Qué hago si el error persiste?

Si después de intentar todos estos métodos el error base de datos wordpress sigue apareciendo, el problema puede ser más profundo. Aquí tienes algunas comprobaciones adicionales:

Revisa los permisos de los archivos: Asegúrate de que los archivos de WordPress tienen los permisos correctos (normalmente 644 para archivos y 755 para carpetas).
Comprueba el espacio en disco: Un disco lleno puede causar errores continuos.
Desactiva plugins y temas: Si puedes acceder al panel de administración (a veces la reparación lo permite), desactiva todos los plugins y cambia a un tema por defecto (como Twenty Twenty-Four). Si el error desaparece, el problema lo causa uno de ellos.
Contacta con tu proveedor de hosting: Ellos pueden revisar los logs del servidor y ver si hay errores de MySQL más graves. Si tu hosting es Syspanel, su soporte técnico está acostumbrado a estos casos y te pueden echar una mano rápidamente.

Preguntas Frecuentes (FAQ)

¿Reparar la base de datos borra mi contenido?
No, en absoluto. Los comandos REPAIR y OPTIMIZE son no destructivos. Solo reconstruyen la estructura de las tablas para que funcionen correctamente. Tus posts, páginas, comentarios y usuarios están a salvo.

¿Cada cuánto tiempo debo reparar mi base de datos?
No es necesario hacerlo con regularidad, solo cuando tengas problemas. Sin embargo, optimizarla una vez al mes puede ayudar al rendimiento, especialmente si tu sitio tiene mucho tráfico.

¿Puedo usar estos métodos si mi hosting es muy básico o compartido?
Depende. El acceso SSH (para WP-CLI) no siempre está disponible en planes compartidos. phpMyAdmin, sin embargo, suele estar disponible en el 99% de los paneles de control. Si no tienes acceso a ninguno, contacta con tu proveedor.

¿Qué significa el error "Table doesn't exist"?
Esto indica que una tabla que WordPress espera encontrar no está en la base de datos. Esto puede pasar por una restauración incompleta o por un plugin que crea tablas y no las elimina bien. En este caso, la reparación simple no crea tablas, tendrías que restaurar desde una copia de seguridad o verificar si el plugin responsable puede recrearla.

[TIP] La mejor cura es la prevención. Realiza copias de seguridad periódicas de tu base de datos. La mayoría de los hostings ofrecen copias automáticas, pero también puedes usar plugins como UpdraftPlus o BackWPup. Así, si algo falla, siempre puedes restaurar a un estado anterior sin daños.

Espero que esta guía te haya sido de ayuda. Como ves, reparar base de datos wordpress no es una tarea de otro mundo. Con un poco de paciencia y siguiendo estos pasos, podrás tener tu sitio web funcionando de nuevo en cuestión de minutos. ¡Mucha suerte!