Fallo de conexión WebRTC: cómo averiguar por qué no conecta una videollamada

Una conexión WebRTC falla cuando los dos dispositivos han probado todos los caminos que conocen entre ellos y ninguno funciona. La causa es casi siempre una red que bloquea el camino, un servidor TURN que falta o está roto, o candidatos que nunca llegaron al otro lado, y puedes saber cuál en unos minutos.
Este artículo repasa cómo encontrarla: qué significa de verdad "failed", cómo probar la red de cada lado, cómo comprobar tu servidor TURN y qué mirar en el navegador.
Qué significa "failed"
Antes de que una llamada conecte, cada navegador reúne sus candidatos, las direcciones en las que se le puede encontrar. Tu servidor de señalización se los pasa al otro lado, y los navegadores prueban parejas de ellos hasta que una pasa. Eso es ICE, y cuando todas las parejas han fallado, la conexión pasa a failed.
Registra primero los estados en ambos lados, porque muestran hasta dónde llegó una llamada:
pc.onconnectionstatechange = () => console.log('connection', pc.connectionState);
pc.oniceconnectionstatechange = () => console.log('ice', pc.iceConnectionState);
pc.onicegatheringstatechange = () => console.log('gathering', pc.iceGatheringState);Firefox lo dice con más claridad en su consola: "ICE failed, add a TURN server". Es un buen consejo, aunque no siempre cuenta toda la historia.
Paso 1: prueba la red de cada lado
Abre el test de WebRTC en los dos dispositivos. No necesita cuenta ni permisos, así que puedes enviárselo a la persona cuya llamada falla. Comprueba el navegador, si UDP sale, cómo asigna direcciones la red y si pasan un relé y un WebSocket. Luego dice con palabras sencillas lo que encontró:
- WebRTC no funciona en este navegador. A menudo lo ha desactivado una extensión, una VPN o una política de empresa. Nada de la red importa hasta arreglar eso.
- UDP parece bloqueado. Desde aquí no pueden conectar las llamadas directas. Solo un relé por TCP puede llevar una llamada, normalmente por el puerto 443.
- Las llamadas necesitarán a menudo un relé. La red es un NAT simétrico, que da un puerto distinto a cada servidor con el que habla. El puerto que otro dispositivo averigua no le sirve entonces a él, así que las conexiones directas fallan con frecuencia.
- Las llamadas deberían conectar. La red mantiene una dirección estable y deja salir UDP. Si este lado está bien, mira el otro.
Dos personas pueden pasar la prueba cada una por su lado y aun así fallar juntas, porque un camino directo exige que lo permitan las dos redes. Para eso está un relé.
Paso 2: comprueba tu servidor TURN
Si cualquiera de los lados necesita un relé y la llamada sigue fallando, el siguiente sospechoso es el servidor TURN. Los problemas habituales:
- No hay ninguno. Con solo STUN en
iceServers, una llamada entre dos redes estrictas no tiene ningún camino. Funciona en tu oficina y falla para algunos de tus usuarios. - Sus credenciales han caducado. Las credenciales con caducidad creadas al cargar la página pueden agotarse antes de que empiece una llamada.
- Sus puertos de relé están cerrados. El servidor da una dirección y no pasa ningún dato.
- Ofrece una sola forma de entrada. Una red que bloquea UDP necesita TURN por TCP o TLS, a ser posible en el puerto 443.
Cómo probar un servidor TURN repasa cada uno de ellos, con nuestro test de servidor TURN para ejecutarlos. Servidores STUN y TURN explica para qué sirve cada uno.
Paso 3: mira los candidatos
Si la red y el relé parecen bien, mira qué probaron en realidad los navegadores. Abre chrome://webrtc-internals en Chrome o Edge, o about:webrtc en Firefox, en otra pestaña mientras dura la llamada. Ambos listan cada conexión, sus candidatos y qué parejas se probaron.
Lo que encuentres apunta a la causa:
- Solo candidatos
host. El navegador nunca llegó a un servidor STUN, así que solo tiene direcciones locales, que no sirven desde otra red. Revisa losiceServersque pasaste y que se pueda llegar al servidor. - Ningún candidato
relay. El servidor TURN rechazó el acceso o no respondió. Los errores del candidato dicen cuál de las dos cosas fue. - Hay candidatos aquí pero ninguno del otro lado. Nunca llegaron, lo que apunta a tu señalización. Comprueba que cada lado los envía y los añade.
- Hay candidatos en ambos lados y todas las parejas fallaron. Las redes bloquean el camino, y sin un relé no tiene arreglo por tu parte.
Una causa frecuente de candidatos que faltan es el momento: añadir uno antes de fijar la descripción remota lanza un error, y el código que se traga el error pierde el candidato. Ponlos en cola hasta que setRemoteDescription() haya terminado.
Si conecta y luego se corta
disconnected no es failed. Significa que los paquetes se detuvieron un momento, como cuando alguien sale del alcance del Wi-Fi, y a menudo se recupera solo. Una vez que llega a failed, una llamada puede recuperarse sin colgar si lo intenta de nuevo:
pc.onconnectionstatechange = () => {
if (pc.connectionState === 'failed') {
pc.restartIce();
}
};restartIce() hace que la siguiente oferta reúna candidatos y pruebe otra vez, así que tu señalización tiene que llevar esa nueva oferta al otro lado.
Cómo lo resuelve WordPlus Cloud
En WordPlus Cloud una llamada va directamente entre dos dispositivos cuando puede, por el relé más cercano a cada persona cuando un cortafuegos lo impide, y por nuestros servidores multimedia cuando ni siquiera llegan los relés, sin colgar. Siempre hay un camino al que recurrir, y no tienes que mantener ninguno. Cómo conectamos a tus usuarios muestra dónde están esos servidores, y conectar usuarios de diferentes regiones explica cómo las llamadas los atraviesan.
Si falla una llamada en nuestra red, el test de conexión muestra si esa red llega a nuestros servidores. La documentación sobre llamadas y las videollamadas para apps muestran cómo construir sobre ella.