ICE收集成功后超时：Angular客户端与Go+PionV4服务器连接失败

问题背景 #

搭建的WebRTC环境流程：

1. 客户端向服务器发送HTTP请求，服务器存储RTC连接数据并向CloudFlare获取TURN凭证
2. 客户端用凭证创建RTCPeerConnection，生成Offer并通过HTTP发送给服务器
3. 数据交换期间，客户端发送的ICE候选全部被缓存
4. 服务器收到Offer后更新存储，添加WebRTC相关数据
5. 服务器设置远端描述
6. 缓存的ICE候选被添加，新候选直接添加无需缓存
7. 服务器生成Answer并返回

当前异常表现：

• 服务器日志：ICE收集状态变为Completed，ICE连接状态先Connecting，10秒后变为Failed
• 客户端ICE连接状态监听器无任何输出
• 服务器仅收到客户端发送的1个ICE候选，自身生成了host、srflx、relay类型的多个候选并尝试发送
• 测试环境：iOS Safari/Chrome设备，蜂窝网络（CloudFlare TURN支持对称NAT），不确定客户端仅发送1个候选是否正常

排查方向 #

客户端ICE候选收集验证 #

• 检查TURN配置完整性：确认传给RTCPeerConnection的ICE配置中，CloudFlare TURN的urls、username、credential是否正确，是否指定了传输协议（如turn:xxx.cloudflare.com?transport=udp）。iOS设备对TURN格式要求严格，缺失参数会导致候选收集异常。
• 监听并输出客户端ICE候选：在Angular代码中给icecandidate事件添加详细日志，打印每个候选的type和candidate字段，确认是否真的只生成1个候选。对称NAT环境下通常会生成relay候选，但数量不止1个，需排查是否未正确监听事件或发送候选到服务器。
• 检查客户端ICE收集状态：监听icegatheringstatechange事件，确认客户端ICE收集状态是否达到completed。若一直处于gathering状态，说明TURN配置无效，无法获取relay候选。

服务器端ICE候选处理逻辑 #

• 确认候选添加时机：Pion要求必须先设置远端描述，再添加ICE候选。检查服务器是否在完成步骤5（设置远端描述）后才执行步骤6（添加缓存候选），否则候选会被忽略。
• 验证服务器候选推送逻辑：现有流程仅提到服务器返回Answer，但未说明自身生成的ICE候选如何传给客户端。WebRTC需要双向交换候选，服务器的候选必须发送给客户端并添加到RTCPeerConnection，否则无法建立连接。
• 检查Pion ICE配置：确认服务器SettingEngine是否启用ICE候选收集，是否允许使用所有网络接口，避免服务器网络限制导致候选无法生成或发送。

连接状态监听与SDP验证 #

• 修复客户端状态监听：检查Angular代码中iceconnectionstatechange事件的绑定是否正确，排除作用域或错误捕获导致的日志无输出问题，直接用console.log输出状态。
• 对比SDP内容：检查客户端Offer和服务器Answer中的ICE参数（如ice-ufrag、ice-pwd）是否一致，Answer是否包含TURN服务器信息。参数不匹配会直接导致连接失败。

网络与TURN服务测试 #

• 验证CloudFlare TURN可用性：在iOS设备上用trickle-ice工具测试TURN服务器是否能正常返回relay候选，确认凭证有效期和权限正确。若TURN服务不可用，客户端无法生成relay候选，对称NAT环境下无法建立连接。
• 尝试TCP传输的TURN配置：部分蜂窝运营商限制UDP流量，可修改TURN配置为turn:xxx.cloudflare.com?transport=tcp，测试是否能改善候选收集情况。iOS Safari对TCP传输的TURN支持良好。

内容的提问来源于stack exchange，提问作者Noel Maróti