El mensaje Flutter waiting for connection from debug service on chrome aparece cuando Flutter intenta iniciar una aplicación web en Chrome, pero no consigue establecer a tiempo la comunicación de depuración con el navegador. Puede quedarse unos segundos durante el arranque; si permanece indefinidamente, no suele resolverse repitiendo el comando sin más. Conviene averiguar si el problema está en la compilación, en el lanzamiento de Chrome, en el puerto local o en la conexión de depuración.
La siguiente guía propone comprobaciones en un orden práctico, desde las más rápidas hasta las que modifican la configuración del proyecto. El objetivo es distinguir un inicio lento de un bloqueo real y corregir la causa sin borrar archivos ni cambiar opciones de seguridad a ciegas.
Qué está esperando Flutter cuando Chrome no termina de arrancar
Al ejecutar una aplicación con flutter run -d chrome, Flutter compila el proyecto para la web, inicia o utiliza un servidor local y abre Chrome en modo de depuración. Después, el proceso de desarrollo necesita comunicarse con el navegador para enviar la aplicación, recibir información de ejecución y habilitar funciones como los puntos de interrupción y la recarga en caliente.
El texto de espera indica que esa conexión no se ha confirmado. No identifica por sí solo la causa. Por ejemplo, Chrome puede haberse abierto correctamente, pero la aplicación todavía estar compilándose; también puede ocurrir que el navegador no llegue a abrirse, que un puerto esté ocupado o que un proceso anterior haya dejado una sesión inconsistente.
Una pausa breve durante la primera compilación puede ser normal, especialmente después de instalar dependencias o cambiar la versión de Flutter. En cambio, si pasan varios minutos sin actividad, no aparece la aplicación y el registro no avanza, es razonable tratarlo como un bloqueo. La diferencia se comprueba observando tanto la terminal como la ventana de Chrome, no solo el último mensaje impreso.
Empieza por separar un retraso de compilación de un fallo de conexión
Antes de modificar el proyecto, ejecuta estos comandos desde su directorio raíz:
- flutter doctor -v: informa sobre la instalación de Flutter y los componentes detectados.
- flutter devices: comprueba si Chrome aparece como dispositivo disponible.
- flutter run -d chrome -v: muestra un registro detallado del proceso de compilación y conexión.
En la salida detallada, busca la última operación que se completa. Si los mensajes se detienen durante la compilación de paquetes, el problema probablemente no es una conexión con Chrome. Si Flutter informa que está lanzando el navegador, pero no se abre ninguna ventana, revisa la instalación o el proceso de Chrome. Si el navegador aparece y la terminal continúa esperando el servicio de depuración, centra las pruebas en la comunicación local, las sesiones anteriores o las restricciones de red.
También conviene comprobar si el proyecto funciona sin iniciar Chrome. Ejecuta flutter build web. Si falla, atiende primero los errores de compilación que devuelve el comando: la conexión de depuración no puede completarse correctamente si la aplicación no se construye. Si termina bien, el resultado no descarta un problema de navegador, pero sí reduce la posibilidad de que el fallo esté en el código o en las dependencias web.
Soluciones seguras para puertos ocupados y procesos antiguos
Flutter y Chrome necesitan procesos y puertos locales disponibles. Una ejecución anterior que quedó abierta puede conservar una sesión, y otra aplicación puede estar utilizando el puerto elegido. Cierra las ventanas de Chrome iniciadas para depuración y detén el proceso de Flutter con Ctrl+C. Después, vuelve a iniciar el proyecto una sola vez. Lanzar varios comandos simultáneos suele dificultar el diagnóstico porque cada instancia puede abrir su propio servidor.
Si el registro menciona un puerto ocupado o la conexión falla repetidamente en una dirección local, prueba un puerto distinto:
flutter run -d chrome –web-port=53127
El número es un ejemplo; puede utilizarse otro puerto libre. Si el cambio permite arrancar la aplicación, la causa probable era una colisión o una regla local asociada al puerto anterior. No hace falta modificar la configuración del router: en el desarrollo habitual, la comunicación se realiza en el propio equipo.
En entornos con VPN, proxy, firewall corporativo o software de seguridad, verifica si una política está bloqueando conexiones de loopback o el proceso de Chrome. No desactives el firewall de forma permanente para probar. Si una prueba temporal, autorizada por las políticas del equipo, identifica el bloqueo, solicita una regla específica para el entorno de desarrollo en lugar de reducir la protección general.
Cuando Chrome abre, pero Flutter no consigue conectarse
Si aparece una ventana del navegador, comprueba que corresponde a la ejecución actual y no a una sesión antigua. Cierra las ventanas de depuración anteriores y vuelve a iniciar Flutter. Evita abrir manualmente otra pestaña con la dirección que muestra la terminal mientras el comando sigue esperando: una pestaña adicional no necesariamente se enlaza con la sesión de depuración que Flutter está intentando crear.
Las extensiones, perfiles gestionados y políticas de empresa también pueden interferir con el inicio o con la comunicación del navegador. Una prueba útil consiste en cerrar Chrome por completo y permitir que Flutter lo abra de nuevo. Si el problema solo aparece en un perfil concreto, prueba con una instalación o perfil limpio siguiendo las normas de seguridad del equipo. No es recomendable añadir opciones como –disable-web-security como solución general: reducen protecciones del navegador y no corrigen la causa habitual de una conexión de depuración atascada.
Comprueba además que la versión de Flutter reconoce el navegador esperado. Si Chrome fue instalado en una ubicación no estándar o hay varias instalaciones, el entorno puede estar lanzando un ejecutable distinto del que se usa habitualmente. El diagnóstico detallado y flutter doctor -v ayudan a detectar discrepancias. Si se cambia la ruta o configuración del navegador, documenta el ajuste para que el proyecto siga siendo reproducible en otros equipos.
Dependencias, caché y configuración del proyecto: qué limpiar y cuándo
Cuando el problema comenzó después de cambiar dependencias, actualizar Flutter o mover el proyecto, revisa primero que los paquetes estén resueltos:
flutter pub get
Luego repite la ejecución. Si hay indicios de artefactos de compilación desactualizados, puede probarse flutter clean y después flutter pub get. Esta operación elimina archivos generados, por lo que la siguiente compilación tardará más; no borra el código fuente, pero tampoco es un remedio universal. Si el bloqueo se debe a un puerto ocupado o a una política del navegador, limpiar la caché no lo solucionará.
En un proyecto recién creado, confirma que la plataforma web está habilitada y que el SDK instalado es el que se espera. Si el fallo apareció inmediatamente después de actualizar Flutter, anota la versión con flutter –version y compara el resultado con el entorno de trabajo del equipo. Cambiar de canal o degradar el SDK debería ser una decisión controlada, no el primer intento: puede introducir diferencias de dependencias y hacer más difícil reproducir el error.
Un caso frecuente en equipos compartidos es que la terminal use una instalación de Flutter distinta de la configurada en el editor. En ese escenario, el comando de terminal y el botón de ejecución pueden comportarse de manera diferente. Compara las rutas que informa el entorno y ejecuta el proyecto desde una única instalación conocida antes de cambiar archivos de configuración.
Un procedimiento breve para aislar la causa sin probar al azar
- Espera un momento si es la primera compilación y observa si la terminal sigue generando actividad.
- Confirma que Chrome aparece en flutter devices y revisa los avisos de flutter doctor -v.
- Detén procesos de Flutter y ventanas de depuración anteriores; inicia una sola sesión.
- Ejecuta flutter run -d chrome -v y determina si el último paso visible pertenece a compilación, lanzamiento o conexión.
- Si hay una indicación de conflicto de puerto, prueba –web-port con un puerto libre.
- Si el navegador abre pero la conexión no se establece, revisa perfil, políticas y herramientas de seguridad local.
- Solo si existen señales de dependencias o artefactos dañados, ejecuta flutter pub get y considera flutter clean.
Por ejemplo, si Chrome se abre y el registro detallado indica que el puerto seleccionado ya estaba en uso, cambiar el puerto es una prueba más informativa que borrar la carpeta de construcción. Si, por el contrario, no se genera la aplicación web, limpiar o revisar dependencias puede tener sentido, pero investigar el firewall todavía no aportaría mucho.
Qué información recopilar si el bloqueo persiste
Si las comprobaciones anteriores no resuelven el problema, guarda la salida relevante de flutter run -d chrome -v, la versión de Flutter, el sistema operativo y el resultado de flutter doctor -v. Anota también si Chrome llegó a abrirse, si cambiar el puerto modificó el comportamiento y cuándo empezó el fallo. No compartas tokens, rutas con datos privados ni información sensible del entorno.
Ese conjunto permite diferenciar un error reproducible del proyecto de una limitación específica del equipo. También evita recomendaciones innecesarias: no es lo mismo una compilación que falla antes de iniciar el navegador que una sesión en la que Chrome ya está abierto y la conexión de depuración nunca se confirma.
Para resolver Flutter waiting for connection from debug service on chrome, la ruta más eficaz es identificar la fase exacta donde se detiene el proceso, eliminar sesiones antiguas y probar un puerto alternativo cuando haya indicios de conflicto. Después se revisan el navegador, las políticas locales y, solo con motivos concretos, las dependencias o la caché. Así se conserva una configuración segura y se evita convertir una espera de diagnóstico en una cadena de cambios al azar.
