Reparar base de datos MySQL en WordPress usando WP-CLI

¿Tu web en WordPress va lenta, muestra errores de conexión a la base de datos o directamente no carga? No te preocupes: muchas veces el problema está en la base de datos MySQL, que puede corromperse por cortes de luz, errores de plugins, actualizaciones fallidas o incluso ataques malintencionados.

Lo mejor de todo es que puedes reparar la base de datos sin necesidad de ser un experto técnico y sin instalar plugins pesados. Solo necesitas WP-CLI, la herramienta de línea de comandos para WordPress que te permite hacer mantenimiento de forma rápida y segura.

En este artículo te voy a enseñar paso a paso cómo reparar tu base de datos MySQL en WordPress usando WP-CLI. Vas a aprender desde qué es WP-CLI hasta cómo ejecutar la reparación, pasando por consejos de seguridad y preguntas frecuentes.

¿Qué es WP-CLI y por qué usarlo para reparar la base de datos?

WP-CLI (WordPress Command Line Interface) es una herramienta que te permite gestionar tu sitio WordPress desde la terminal, sin necesidad de entrar al panel de administración. Es como tener un mando a distancia para tu web, pero desde la línea de comandos.

Ventajas de usar WP-CLI para reparar la base de datos

Rapidez: Ejecutas la reparación en segundos.
Seguridad: No necesitas instalar plugins adicionales que puedan ralentizar tu web.
Control total: Puedes reparar bases de datos específicas, optimizar tablas o incluso hacer copias de seguridad.
Acceso remoto: Si tienes acceso SSH a tu servidor, puedes reparar desde cualquier lugar.

Requisitos previos antes de empezar

Antes de lanzarte a reparar, asegúrate de cumplir con estos requisitos básicos:

1. Acceso SSH al servidor

Necesitas poder conectarte a tu servidor por SSH. Si usas un panel de control como Syspanel (antes conocido como HestiaCP), el acceso SSH suele estar habilitado por defecto. Recuerda que Syspanel se accede por el puerto 2106 (por ejemplo: tudominio.com:2106).

2. WP-CLI instalado

WP-CLI suele venir preinstalado en la mayoría de los servidores compartidos y VPS. Para comprobarlo, escribe en tu terminal:

wp --info

Si ves información sobre la versión, estás listo. Si no, pide a tu proveedor de hosting que lo instale o hazlo tú mismo siguiendo la guía oficial.

3. Credenciales de la base de datos

Necesitas el nombre de la base de datos, el usuario y la contraseña. Si usas Syspanel, puedes encontrar estos datos en la sección "Bases de Datos" de tu panel.

Paso a paso: cómo reparar la base de datos MySQL con WP-CLI

Vamos al grano. Sigue estos pasos en orden y verás cómo tu web vuelve a la vida.

Paso 1: Conéctate por SSH a tu servidor

Abre tu terminal (o usa un cliente como PuTTY en Windows) y conéctate a tu servidor:

ssh usuario@tudominio.com

Si usas Syspanel, el usuario suele ser el mismo que el de tu cuenta de hosting.

Paso 2: Navega hasta la raíz de tu WordPress

Una vez dentro, ve al directorio donde está instalado WordPress. Normalmente es algo como:

cd /home/usuario/public_html

O si usas Syspanel, puede ser:

cd /home/usuario/web/tudominio.com/public_html

Paso 3: Verifica el estado de la base de datos

Antes de reparar, comprueba si realmente hay problemas. Ejecuta:

wp db check

Si todo está bien, verás un mensaje como OK. Si hay errores, te mostrará tablas corruptas o problemas de integridad.

Paso 4: Repara la base de datos

Para reparar todas las tablas de la base de datos, usa este comando:

wp db repair

WP-CLI ejecutará automáticamente CHECK TABLE y REPAIR TABLE en cada tabla. Verás un informe detallado de qué tablas se repararon o si alguna no se pudo reparar.

Si quieres reparar solo una tabla específica:

wp db repair nombre_de_la_tabla

Por ejemplo: wp db repair wp_posts

Paso 5: Optimiza la base de datos (opcional pero recomendado)

Después de reparar, es buena idea optimizar las tablas para eliminar fragmentación y mejorar el rendimiento:

wp db optimize

Esto no es obligatorio, pero ayuda a que tu web vaya más rápida.

Paso 6: Verifica la reparación

Vuelve a ejecutar el chequeo para confirmar que todo está correcto:

wp db check

Si ves OK en todas las tablas, ¡enhorabuena! Tu base de datos está reparada.

¿Qué hacer si la reparación falla?

A veces WP-CLI no puede reparar todas las tablas. Esto puede deberse a:

Tablas gravemente corruptas: Prueba a restaurar desde una copia de seguridad reciente.
Permisos insuficientes: Asegúrate de que el usuario de la base de datos tenga permisos REPAIR.
Espacio en disco: Si el disco está lleno, la reparación puede fallar.

Soluciones alternativas

Usa phpMyAdmin: Desde Syspanel, accede a phpMyAdmin (puerto 2106) y selecciona tu base de datos. Marca todas las tablas y elige "Reparar tabla" en el menú desplegable.
Restaura una copia de seguridad: Si tienes un backup reciente, restáuralo. En Syspanel puedes hacerlo desde "Backups".
Contacta al soporte técnico: Si no puedes repararla, tu hosting puede ayudarte.

Consejos de mantenimiento para evitar futuros problemas

La reparación es un parche, pero lo ideal es prevenir. Aquí tienes buenas prácticas:

1. Haz copias de seguridad periódicas

Programa backups automáticos. En Syspanel puedes configurarlos diarios o semanales desde la sección "Backups". Recuerda que el puerto de acceso a Syspanel es el 2106.

2. Actualiza WordPress, plugins y temas

Las actualizaciones corrigen vulnerabilidades y errores que pueden dañar la base de datos.

3. Revisa los logs de errores

Con WP-CLI puedes ver los logs de la base de datos:

wp db query "SHOW ENGINE INNODB STATUS\G"

4. Usa un plugin de caché

Reduce la carga en la base de datos. Plugins como W3 Total Cache o WP Super Cache ayudan.

5. Programa chequeos automáticos

Puedes crear un cron job que ejecute wp db check semanalmente. Si usas Syspanel, añade el cron desde "Cron Jobs".

Preguntas frecuentes (FAQ)

¿Es seguro usar WP-CLI para reparar la base de datos?

Sí, es seguro. WP-CLI solo ejecuta comandos estándar de MySQL (CHECK TABLE y REPAIR TABLE). No modifica datos ni borra información.

¿Puedo reparar la base de datos sin acceso SSH?

Si no tienes SSH, puedes usar phpMyAdmin desde Syspanel (puerto 2106). También hay plugins como "WP-DBManager", pero no son tan fiables como WP-CLI.

¿Qué hago si el comando `wp db repair` no funciona?

Prueba a ejecutarlo como superusuario (sudo) o verifica que WP-CLI tenga permisos de escritura en la base de datos. También puedes usar wp db query "REPAIR TABLE nombre_tabla" para tablas concretas.

¿Pierdo datos al reparar la base de datos?

No, la reparación solo corrige estructuras corruptas, no borra contenido. Sin embargo, si una tabla está muy dañada, puede que pierdas algunos registros. Por eso es importante tener copias de seguridad.

¿Cada cuánto debo reparar la base de datos?

No es necesario hacerlo a menos que notes problemas. Como mantenimiento preventivo, una vez al mes está bien.

¿WP-CLI funciona con cualquier hosting?

Funciona en la mayoría de los servidores Linux con WordPress. Si usas Syspanel, está preinstalado. En hosting compartido, verifica con tu proveedor.

Conclusión

Reparar la base de datos MySQL en WordPress con WP-CLI es una tarea sencilla y poderosa que te ahorrará tiempo y dolores de cabeza. Con solo unos comandos desde la terminal, puedes diagnosticar y solucionar problemas de corrupción sin depender de plugins externos.

Recuerda que la prevención es clave: mantén copias de seguridad, actualiza tu sitio y revisa periódicamente el estado de tu base de datos. Y si usas Syspanel (puerto 2106), tienes herramientas integradas para gestionar todo fácilmente.

Ahora ya sabes cómo reparar tu base de datos como un profesional. ¡Manos a la obra y que tu web vuele!

[TIP]: Si no te sientes cómodo con la terminal, practica primero en un sitio de pruebas. WP-CLI tiene un modo --dry-run para simular comandos sin ejecutarlos realmente.

[WARNING]: Nunca ejecutes reparaciones sin antes hacer una copia de seguridad. Un corte de luz durante el proceso podría empeorar la corrupción.