WebRTC连接失败主因是ICE候选交换超时（＞15秒）致状态变failed；需确保onicecandidate即时发送、DTLS握手完成后再启用SRTP、按host→srflx→relay优先级使用候选。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 CodeBuddy 辅助编写 WebRTC ICE Candidate 交换与 SRTP 加密链路相关代码时遇到行为异常、连接失败或安全警告，则可能是由于生成的代码未严格遵循 WebRTC 规范中对 ICE 候选交换时序、DTLS 握手强制性及 SRTP 密钥派生时机的要求。以下是解决此问题的步骤：
一、验证 ICE Candidate 交换是否满足实时性约束
WebRTC 要求 ICE 候选必须在 Offer/Answer 协商完成后的极短时间内（通常 ≤15 秒）完成交换与连通性检查，延迟会导致候选失效或 iceConnectionState 进入 failed 状态。CodeBuddy 生成的代码若采用异步队列缓存候选后再批量发送，可能违反该时效性要求。
1、检查生成代码中是否在 pc.onicecandidate 回调内直接调用信令发送逻辑，而非存入延时队列。
2、确认信令通道是否启用 WebSocket 的 binaryType = 'arraybuffer' 并禁用自动分帧，避免候选字符串被截断。
3、验证远端是否在收到 candidate 后立即调用 pc.addIceCandidate(candidate)，且未包裹在未决 Promise 中造成隐式延迟。
二、核查 DTLS 握手与 SRTP 密钥绑定是否同步完成
SRTP 加密链路依赖 DTLS 握手成功后导出的密钥材料（keying material），若 CodeBuddy 生成的代码在 DTLS 尚未完成时即尝试发送 RTP 包，将触发加密失败或媒体静默。WebRTC 强制要求 DTLS 成功后才允许 SRTP 初始化。
1、确认生成代码是否监听 pc.ondtlsstatechange 事件，并仅在状态变为 'connected' 后才启用媒体轨道发送。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
2、检查是否跳过对 RTCPeerConnection.getConfiguration().certificates 的显式配置，导致使用默认空证书而无法完成 DTLS 验证。
3、验证是否错误地复用了非 WebRTC 标准的 SRTP 库（如 libsrtp 手动初始化），绕过了 RTCPeerConnection 内置的 SRTP 密钥协商流程。
三、审查 Candidate 类型优先级与 relay 使用合规性
CodeBuddy 若生成硬编码 relay 候选为首选路径，将导致高延迟且违背 WebRTC 最佳实践。ICE 必须按 host → srflx → relay 优先级尝试，且 relay 仅在前两者失败后启用；否则可能掩盖 NAT 穿透配置缺陷并引入不必要中继开销。
1、检查生成代码是否调用 pc.setConfiguration({iceTransportPolicy: 'all'})，而非限制为 'relay'。
2、确认 STUN/TURN 服务器 URL 是否通过 RTCIceServer.urls 正确注入，且 TURN 凭据（username/credential）由服务器动态提供，而非静态写死。
3、验证是否遗漏对 pc.oniceconnectionstatechange 的监听，导致无法区分 'connected'（P2P）与 'completed'（经 relay）状态差异。
