Aprende a depurar WordPress con WP-CLI: logs, debug, WP_DEBUG y comandos pr\u00e1cticos para encontrar errores m\u00e1s r\u00e1pido.<\/p>\n
Cuando un sitio WordPress empieza a fallar, el panel de administraci\u00f3n no siempre es el mejor lugar para investigar. A veces el problema est\u00e1 en un plugin, en una consulta a base de datos, en una configuraci\u00f3n del servidor o incluso en una tarea programada que rompe la carga de p\u00e1ginas. En esos casos, WP-CLI<\/strong> se convierte en una herramienta especialmente \u00fatil para diagnosticar el origen del error desde la consola, con m\u00e1s control y menos ruido visual.<\/p>\n Si ya has dado tus primeros pasos con la terminal y conoces comandos b\u00e1sicos de gesti\u00f3n, esta gu\u00eda te ayudar\u00e1 a ir un nivel m\u00e1s all\u00e1. La idea no es repetir lo esencial sobre qu\u00e9 es WP-CLI o c\u00f3mo se instala, sino mostrar c\u00f3mo usarlo como una herramienta de debugging<\/strong> para aislar incidencias, revisar informaci\u00f3n t\u00e9cnica y acelerar la resoluci\u00f3n de problemas.<\/p>\n Depurar desde consola tiene una ventaja clara: puedes trabajar sin depender del frontend ni del escritorio de WordPress. Eso es clave cuando hay pantallas en blanco, errores fatales o conflictos que impiden cargar el administrador. Adem\u00e1s, la salida de los comandos es directa y puede integrarse en scripts, logs o procesos de soporte.<\/p>\n WP-CLI tambi\u00e9n resulta especialmente pr\u00e1ctico en entornos remotos, despliegues automatizados y servidores gestionados. Si trabajas con varias instalaciones, conviene apoyarse en m\u00e9todos organizados como los aliases en WP-CLI<\/a>, algo que facilita repetir diagn\u00f3sticos en diferentes sitios sin perder tiempo.<\/p>\n Uno de los primeros pasos para depurar WordPress consiste en habilitar el modo de depuraci\u00f3n. WordPress ofrece constantes como WP_DEBUG<\/strong>, WP_DEBUG_LOG<\/strong> y WP_DEBUG_DISPLAY<\/strong>, que permiten registrar errores y controlar si se muestran en pantalla.<\/p>\n Con WP-CLI, puedes inspeccionar y modificar estos valores sin entrar manualmente por FTP o el editor de archivos. Antes de tocar nada, haz una copia de seguridad o aseg\u00farate de tener un snapshot v\u00e1lido. Si no la tienes reciente, revisa primero c\u00f3mo realizar un backup de WordPress con WP-CLI<\/a>.<\/p>\n Estos cambios son muy \u00fatiles cuando el sitio sigue funcionando, pero sospechas que algo est\u00e1 generando warnings, notices o errores fatales invisibles para el usuario final.<\/p>\n Una vez activado el registro de errores, el siguiente paso es revisar qu\u00e9 est\u00e1 pasando. En muchos entornos de WordPress, el archivo debug.log<\/strong> se ubica dentro de Este enfoque permite reproducir el fallo y observar el mensaje exacto en paralelo. Es especialmente \u00fatil para detectar rutas rotas, funciones obsoletas, conflictos de hooks o llamadas a clases que no existen.<\/p>\n Si el problema parece estar relacionado con cambios recientes en la base de datos, puede ayudarte repetir determinadas comprobaciones con comandos de exportaci\u00f3n e importaci\u00f3n. En ese caso, es recomendable conocer tambi\u00e9n la gu\u00eda sobre c\u00f3mo exportar e importar la base de datos con WP-CLI<\/a>.<\/p>\n Uno de los motivos m\u00e1s frecuentes de errores en WordPress es un plugin incompatible o un tema con c\u00f3digo defectuoso. WP-CLI permite desactivar componentes r\u00e1pidamente, incluso cuando el panel no responde.<\/p>\n Esta t\u00e9cnica es b\u00e1sica, pero muy efectiva. Si el sitio deja de fallar tras desactivar un plugin, ya tienes una pista clara. Para una gesti\u00f3n m\u00e1s detallada, te puede interesar repasar c\u00f3mo instalar y activar plugins con WP-CLI<\/a> o c\u00f3mo instalar y cambiar temas con WP-CLI<\/a>, ya que entender el ciclo completo ayuda a depurar con m\u00e1s criterio.<\/p>\n Una de las funciones m\u00e1s potentes para depurar WordPress es wp eval<\/strong>, que ejecuta fragmentos de PHP dentro del contexto real de WordPress. Esto permite verificar funciones, constantes, opciones o consultas sin tener que crear un plugin temporal.<\/p>\n Con este tipo de comandos puedes confirmar si el problema est\u00e1 en WordPress, en un plugin concreto o en una incompatibilidad de versi\u00f3n. Tambi\u00e9n es una forma r\u00e1pida de validar hip\u00f3tesis cuando el fallo aparece solo en ciertas condiciones.<\/p>\n Eso s\u00ed, conviene usar Muchos errores de WordPress no aparecen en pantalla, pero degradan el sitio por dentro. Tareas cron atascadas, acciones agendadas que no se ejecutan o jobs de plugins que fallan pueden generar lentitud, comportamientos extra\u00f1os o avisos recurrentes en logs.<\/p>\n WP-CLI permite inspeccionar las tareas cron registradas y ejecutar eventos de forma manual para verificar si el problema se reproduce fuera del horario habitual.<\/p>\n Cuando una tarea falla de forma repetida, este tipo de auditor\u00eda ayuda a distinguir si el origen est\u00e1 en WordPress, en el servidor o en una integraci\u00f3n externa. Es una buena pr\u00e1ctica, adem\u00e1s, si ya automatizas tareas con consola y quieres profundizar en WP-CLI y cron<\/a>.<\/p>\n En procesos de depuraci\u00f3n tambi\u00e9n es frecuente encontrar opciones corruptas, transients obsoletos o cach\u00e9s que impiden ver el comportamiento real del sitio. Aunque limpiar cach\u00e9 no siempre resuelve el problema de fondo, s\u00ed sirve para eliminar variables y confirmar si el fallo persiste.<\/p>\n Antes de seguir investigando, puede resultar \u00fatil vaciar transients o cach\u00e9s de forma controlada. Si quieres reforzar esa parte del diagn\u00f3stico, puedes consultar c\u00f3mo limpiar la cach\u00e9 y transients con WP-CLI<\/a>.<\/p>\n En algunos escenarios, incluso conviene comprobar si una URL antigua, un dominio temporal o una ruta mal migrada est\u00e1 provocando el conflicto. Para ello, el flujo de trabajo se complementa bien con buscar y reemplazar URLs en WordPress con WP-CLI<\/a>, una t\u00e9cnica muy habitual en migraciones y entornos de staging.<\/p>\n Depurar no consiste solo en \u201cprobar cosas\u201d hasta dar con el fallo. Lo ideal es seguir un orden: validar logs, reproducir el problema, aislar plugins o temas, revisar cron, comprobar constantes de debug y documentar el resultado. As\u00ed evitas perder tiempo y reduces el riesgo de introducir nuevos errores.<\/p>\n Una estrategia recomendable es trabajar siempre de menos a m\u00e1s impacto. Primero lectura de logs, despu\u00e9s comprobaciones con Un error muy com\u00fan es activar WP_DEBUG<\/strong> sin desactivar la visualizaci\u00f3n de errores en un sitio p\u00fablico. Eso puede exponer informaci\u00f3n sensible o romper la experiencia del usuario. Otro fallo frecuente es modificar archivos sin registrar antes una copia de seguridad.<\/p>\n Tambi\u00e9n conviene evitar conclusiones precipitadas. Que un plugin deje de fallar al desactivarlo no significa necesariamente que sea el culpable \u00fanico: puede existir un conflicto de versiones, una dependencia no satisfecha o un problema de datos heredados.<\/p>\n En ese sentido, WP-CLI da velocidad, pero el criterio t\u00e9cnico sigue siendo esencial. La combinaci\u00f3n de consola, logs y pruebas controladas es la forma m\u00e1s s\u00f3lida de depurar WordPress con precisi\u00f3n.<\/p>\n WP-CLI no solo sirve para administrar WordPress m\u00e1s r\u00e1pido; tambi\u00e9n es una herramienta muy potente para diagnosticar incidencias con un enfoque profesional. Al activar el debug, revisar logs, aislar plugins y temas, y probar c\u00f3digo dentro del contexto real de WordPress, puedes encontrar el origen de muchos problemas sin depender del panel de administraci\u00f3n.<\/p>\n Si ya usas WP-CLI para tareas de gesti\u00f3n, el siguiente paso l\u00f3gico es integrarlo en tu flujo de soporte y mantenimiento. Y si quieres seguir ampliando tu dominio de la herramienta, merece la pena explorar art\u00edculos sobre backups, despliegues, automatizaci\u00f3n y gesti\u00f3n avanzada.<\/p>\n Documentaci\u00f3n oficial de WP-CLI<\/a><\/p>\n Debugging in WordPress – documentaci\u00f3n oficial<\/a><\/p>\nPor qu\u00e9 WP-CLI es tan \u00fatil para depurar<\/h2>\n
Activar el modo debug de WordPress desde consola<\/h2>\n
# Ver el valor actual de una constante en wp-config.php\nwp config get WP_DEBUG\n\n# Activar el registro de errores\nwp config set WP_DEBUG true --raw\n\n# Guardar los errores en el archivo debug.log\nwp config set WP_DEBUG_LOG true --raw\n\n# Evitar que los errores se muestren en pantalla\nwp config set WP_DEBUG_DISPLAY false --raw<\/code><\/pre>\nRevisar errores y logs sin salir de la terminal<\/h2>\n
wp-content<\/code>. Desde la consola puedes inspeccionarlo con herramientas est\u00e1ndar del sistema operativo.<\/p>\n# Ver las \u00faltimas l\u00edneas del log\ntail -n 50 wp-content\/debug.log\n\n# Seguir el archivo en tiempo real mientras reproduces el error\ntail -f wp-content\/debug.log<\/code><\/pre>\nComprobar el estado de plugins y temas sospechosos<\/h2>\n
# Ver qu\u00e9 plugins est\u00e1n activos\nwp plugin list --status=active\n\n# Desactivar un plugin concreto\nwp plugin deactivate nombre-del-plugin\n\n# Desactivar todos los plugins para aislar el problema\nwp plugin deactivate --all\n\n# Cambiar temporalmente a un tema por defecto\nwp theme activate twentytwentyfour<\/code><\/pre>\nUsar wp eval para probar c\u00f3digo y detectar fallos<\/h2>\n
# Probar si una opci\u00f3n existe\nwp eval 'var_dump(get_option(\"blogname\"));'\n\n# Comprobar el estado de una funci\u00f3n o clase\nwp eval 'var_dump(function_exists(\"wc_get_product\"));'\n\n# Ejecutar una prueba simple de carga\nwp eval 'echo get_stylesheet();'<\/code><\/pre>\nwp eval<\/code> con prudencia. Si ejecutas c\u00f3digo que modifica datos, hazlo solo cuando entiendas bien el impacto. En contextos de mantenimiento, es preferible combinar estas pruebas con una revisi\u00f3n previa de la base de datos y con comandos de optimizaci\u00f3n, como los que se explican en c\u00f3mo optimizar la base de datos de WordPress desde consola<\/a>.<\/p>\nAuditar tareas programadas y procesos que fallan en segundo plano<\/h2>\n
# Listar eventos cron programados\nwp cron event list\n\n# Ejecutar todos los eventos debidos\nwp cron event run --due-now\n\n# Ejecutar un hook espec\u00edfico\nwp cron event run nombre_del_hook<\/code><\/pre>\nBuscar valores incorrectos y limpiar estados rotos<\/h2>\n
C\u00f3mo organizar una depuraci\u00f3n segura y repetible<\/h2>\n
wp eval<\/code>, y solo al final cambios de configuraci\u00f3n o desactivaciones globales. En entornos de producci\u00f3n, esta disciplina marca la diferencia entre un diagn\u00f3stico limpio y una incidencia mayor.<\/p>\nErrores habituales al depurar con wp-cli<\/h2>\n
Conclusi\u00f3n<\/h2>\n
Fuentes y lecturas recomendadas<\/h3>\n