{"id":1331,"date":"2026-06-24T10:37:15","date_gmt":"2026-06-24T08:37:15","guid":{"rendered":"https:\/\/vermiip.es\/blog\/?p=1331"},"modified":"2026-06-24T10:37:15","modified_gmt":"2026-06-24T08:37:15","slug":"wp-cli-no-funciona-causas-y-soluciones","status":"publish","type":"post","link":"https:\/\/vermiip.es\/blog\/wp-cli-no-funciona-causas-y-soluciones\/","title":{"rendered":"WP-CLI no funciona: causas y soluciones"},"content":{"rendered":"

Descubre por qu\u00e9 WP-CLI no funciona, c\u00f3mo detectar la causa real y qu\u00e9 soluciones aplicar en WordPress paso a paso.<\/p>\n

WP-CLI se ha convertido en una herramienta esencial para administrar WordPress desde la terminal, pero cuando falla, el impacto puede ser inmediato: despliegues detenidos, tareas automatizadas en pausa o soporte t\u00e9cnico bloqueado. La buena noticia es que la mayor\u00eda de los problemas tienen una causa concreta y detectable.<\/p>\n

En este art\u00edculo vamos a centrarnos en los fallos m\u00e1s habituales cuando WP-CLI no funciona<\/strong>, c\u00f3mo identificarlos sin perder tiempo y qu\u00e9 medidas aplicar para recuperar el acceso. Si a\u00fan est\u00e1s dando tus primeros pasos, conviene revisar tambi\u00e9n c\u00f3mo comprobar si WP-CLI est\u00e1 instalado correctamente<\/a> y errores comunes al usar WP-CLI y c\u00f3mo solucionarlos<\/a>, porque muchos s\u00edntomas se parecen entre s\u00ed.<\/p>\n

Antes de asumir que el problema es WP-CLI<\/h2>\n

Cuando un comando falla, el instinto suele ser culpar a la herramienta. Sin embargo, en entornos WordPress el error puede estar en el PATH, en el usuario del sistema, en la versi\u00f3n de PHP, en permisos del directorio o incluso en un conflicto puntual del sitio. Por eso la clave es aislar el origen.<\/p>\n

Conviene entender si el problema aparece al ejecutar wp<\/strong> desde cualquier ruta, solo dentro de un proyecto concreto o \u00fanicamente en scripts automatizados. Ese peque\u00f1o detalle suele cambiar por completo el diagn\u00f3stico.<\/p>\n

1. El comando no existe o no est\u00e1 en el path<\/h3>\n

Uno de los casos m\u00e1s frecuentes es que la terminal responda con un mensaje tipo \u201ccommand not found\u201d o equivalente. Esto suele indicar que WP-CLI no est\u00e1 accesible globalmente o que la ruta al ejecutable no se ha a\u00f1adido correctamente al entorno.<\/p>\n

Si ya revisaste la instalaci\u00f3n, el siguiente paso es verificar desde d\u00f3nde intentas ejecutarlo. En servidores compartidos o entornos con varias cuentas, es com\u00fan que WP-CLI est\u00e9 disponible para un usuario y no para otro.<\/p>\n

# Verifica si el binario responde\nwp --info\n\n# Comprueba la ruta que est\u00e1 usando el sistema\nwhich wp\n\n# En algunos entornos tambi\u00e9n puede ayudarte\necho $PATH\n<\/code><\/pre>\n
Si which wp<\/strong> no devuelve nada, el problema no suele estar en WordPress, sino en el sistema operativo o la configuraci\u00f3n del shell. En ese caso, revisar la instalaci\u00f3n de nuevo es lo correcto, especialmente si sigues una gu\u00eda como c\u00f3mo instalar WP-CLI paso a paso<\/a>.<\/p>\n
2. Versi\u00f3n de php incompatible<\/h3>\n
WP-CLI depende de PHP para funcionar. Cuando la versi\u00f3n de PHP del sistema no es compatible, el error puede manifestarse de formas distintas: mensajes en blanco, fallos al cargar comandos o advertencias que no aparecen en el panel de WordPress.<\/p>\n
Este punto es especialmente importante en servidores donde coexisten varias versiones de PHP. El PHP usado por la web no siempre coincide con el PHP que usa la terminal.<\/p>\n
# Verifica la versi\u00f3n de PHP en CLI\nphp -v\n\n# Comprueba informaci\u00f3n \u00fatil de WP-CLI\nwp --info\n<\/code><\/pre>\n
Si la versi\u00f3n de PHP de consola es demasiado antigua o presenta extensiones ausentes, WP-CLI puede fallar aunque el sitio web siga funcionando con normalidad. En ese escenario, la soluci\u00f3n pasa por ajustar el binario de PHP del sistema o actualizar la versi\u00f3n disponible en la terminal.<\/p>\n
3. Permisos insuficientes en archivos o directorios<\/h3>\n
Muchos errores de WP-CLI no son realmente \u201cerrores de WP-CLI\u201d, sino problemas de permisos. Esto ocurre al intentar leer el archivo wp-config.php<\/strong>, acceder a la base de datos, escribir en wp-content<\/strong> o ejecutar acciones que requieren privilegios concretos.<\/p>\n
Si el comando funciona con un usuario pero falla con otro, probablemente est\u00e9s ante un conflicto de permisos o propiedad de archivos. Esto tambi\u00e9n sucede cuando se utilizan despliegues autom\u00e1ticos o scripts bash que act\u00faan con un usuario de sistema distinto al habitual. Si trabajas con automatizaci\u00f3n, te ser\u00e1 \u00fatil revisar c\u00f3mo usar WP-CLI en scripts bash<\/a>.<\/p>\n
En general, la soluci\u00f3n no consiste en \u201cdar permisos m\u00e1ximos\u201d, sino en corregir propietarios, grupos y acceso m\u00ednimo necesario. Dar permisos excesivos puede generar riesgos de seguridad dif\u00edciles de detectar a posteriori.<\/p>\n
4. Est\u00e1s ejecutando wp-cli en el directorio equivocado<\/h3>\n
WP-CLI necesita ubicarse dentro de una instalaci\u00f3n v\u00e1lida de WordPress para cargar el entorno correctamente. Si ejecutas comandos desde una carpeta incorrecta, es posible que el sistema no encuentre el sitio o que cargue una configuraci\u00f3n inesperada.<\/p>\n
Este fallo aparece mucho en servidores con m\u00faltiples instalaciones, entornos de staging y estructuras personalizadas. Tambi\u00e9n es habitual al conectarse por SSH y asumir que la ruta actual es la correcta sin verificarla.<\/p>\n
Para evitarlo, confirma siempre que el directorio contiene la ra\u00edz de WordPress o usa la opci\u00f3n –path<\/strong> cuando necesites apuntar a una ubicaci\u00f3n espec\u00edfica.<\/p>\n
# Ejecutar WP-CLI indicando la ruta exacta del sitio\nwp --path=\/var\/www\/html\/mi-sitio core version\n<\/code><\/pre>\n
Si administras varios sitios, esta pr\u00e1ctica es todav\u00eda m\u00e1s importante. En ese caso, puedes complementar este enfoque con c\u00f3mo gestionar m\u00faltiples instalaciones de WordPress con WP-CLI<\/a>.<\/p>\n
5. La base de datos no responde<\/h3>\n
Otra causa habitual es que WP-CLI s\u00ed arranque, pero falle cuando intenta conectar con MySQL o MariaDB. En esos casos, el origen puede estar en credenciales incorrectas, en el servicio de base de datos ca\u00eddo o en un wp-config.php<\/strong> desalineado con el entorno actual.<\/p>\n
Si la conexi\u00f3n falla, algunos comandos se detienen antes de mostrar resultados \u00fatiles. Esto afecta especialmente a tareas como exportaciones, importaciones, b\u00fasquedas y reemplazos, o limpieza de transients. Revisar primero la conectividad puede ahorrarte mucho tiempo.<\/p>\n
Cuando el problema es de base de datos, conviene comprobar el fichero de configuraci\u00f3n, validar que el servidor de base de datos est\u00e9 activo y revisar si hay restricciones de firewall o credenciales obsoletas.<\/p>\n
6. El sitio tiene un conflicto de plugins o temas<\/h3>\n
WP-CLI puede cargar WordPress con el contexto del sitio, y eso significa que plugins o temas defectuosos tambi\u00e9n pueden provocar fallos. Aunque la interfaz de administraci\u00f3n no est\u00e9 accesible, el problema puede seguir estando en el c\u00f3digo del proyecto.<\/p>\n
Este tipo de conflictos se nota especialmente al ejecutar comandos que cargan gran parte del entorno, como actualizaciones, limpiezas o tareas de mantenimiento. Si sospechas de una extensi\u00f3n concreta, arranca el diagn\u00f3stico desactivando plugins o revisando el comportamiento en modo aislado.<\/p>\n
Para operaciones de mantenimiento avanzadas, suele ser \u00fatil combinar esta revisi\u00f3n con tareas como las que explicamos en c\u00f3mo depurar WordPress con WP-CLI<\/a> y c\u00f3mo detectar plugins vulnerables con WP-CLI<\/a>.<\/p>\n
7. El hosting limita la ejecuci\u00f3n por consola<\/h3>\n
No todos los proveedores permiten el mismo nivel de acceso a la terminal. En algunos hosting compartidos, ciertas funciones est\u00e1n limitadas por seguridad o por pol\u00edticas internas. Eso puede provocar que WP-CLI funcione parcialmente, que algunos comandos sean bloqueados o que la sesi\u00f3n SSH tenga restricciones inesperadas.<\/p>\n
En entornos gestionados como Plesk o cPanel, el comportamiento tambi\u00e9n puede variar seg\u00fan la configuraci\u00f3n del servidor y los permisos asignados a la cuenta. Si trabajas en ese escenario, merece la pena consultar WP-CLI en servidores con Plesk o cPanel: gu\u00eda pr\u00e1ctica<\/a>.<\/p>\n
Cuando la limitaci\u00f3n viene del hosting, la soluci\u00f3n no siempre est\u00e1 en el c\u00f3digo. A veces hay que pedir soporte, cambiar de plan o usar una cuenta con privilegios adecuados.<\/p>\n
C\u00f3mo diagnosticar wp-cli no funciona de forma ordenada<\/h2>\n
Una secuencia de diagn\u00f3stico simple evita pruebas innecesarias. Primero, valida que el comando existe en el sistema. Despu\u00e9s, comprueba la versi\u00f3n de PHP en consola. Luego confirma que est\u00e1s en la ruta correcta del proyecto. Y finalmente revisa permisos, base de datos y posibles conflictos del sitio.<\/p>\n
Si el problema persiste, prueba comandos muy b\u00e1sicos en lugar de tareas complejas. Por ejemplo, wp –info<\/strong> o wp core version<\/strong> son mejores puntos de partida que una importaci\u00f3n o una actualizaci\u00f3n masiva.<\/p>\n
# Secuencia de verificaci\u00f3n r\u00e1pida\nwp --info\nphp -v\npwd\nwp core version\n\n# Si sospechas de la ruta, especifica el path\nwp --path=\/ruta\/al\/sitio core version\n<\/code><\/pre>\n
Este enfoque te permite distinguir si el fallo est\u00e1 en el propio entorno o en una acci\u00f3n concreta del sitio. Tambi\u00e9n ayuda a comunicar mejor el problema al soporte t\u00e9cnico o al equipo de sistemas.<\/p>\n
Buenas pr\u00e1cticas para evitar fallos recurrentes<\/h2>\n
La prevenci\u00f3n es tan importante como la correcci\u00f3n. Mantener PATH y versiones de PHP coherentes, documentar la ruta de cada instalaci\u00f3n, usar usuarios de sistema bien definidos y evitar cambios manuales sin control reduce los errores de forma notable.<\/p>\n
Tambi\u00e9n es buena idea integrar WP-CLI en flujos consistentes: scripts, despliegues, tareas programadas y operaciones repetibles. Eso minimiza la intervenci\u00f3n manual y hace m\u00e1s f\u00e1cil detectar cu\u00e1ndo algo deja de funcionar.<\/p>\n
Si quieres llevarlo un paso m\u00e1s all\u00e1, puedes reforzar tu operativa con recursos como c\u00f3mo automatizar tareas de WordPress con WP-CLI y cron<\/a> o despliegues autom\u00e1ticos de WordPress con WP-CLI<\/a>.<\/p>\n
Conclusi\u00f3n<\/h2>\n
Cuando WP-CLI no funciona<\/strong>, la soluci\u00f3n rara vez es gen\u00e9rica. Normalmente hay una causa concreta detr\u00e1s: ruta incorrecta, PHP incompatible, permisos insuficientes, base de datos inaccesible, conflicto de plugins o limitaciones del hosting. La clave es diagnosticar por capas y no asumir el primer error como definitivo.<\/p>\n
Si trabajas con WordPress desde la terminal con frecuencia, dominar este proceso de depuraci\u00f3n te ahorrar\u00e1 tiempo, reducir\u00e1 riesgos y har\u00e1 tus tareas de mantenimiento mucho m\u00e1s fiables. Y si necesitas una visi\u00f3n m\u00e1s amplia del ecosistema, puedes complementar este art\u00edculo con la gu\u00eda de qu\u00e9 es WP-CLI y para qu\u00e9 sirve en WordPress<\/a>.<\/p>\n
Fuentes y lecturas recomendadas<\/h3>\n