百度一镜数字人连接超时本质是客户端无法在限定时间内完成tcp三次握手或tls协商，90%以上由本地网络策略导致，需依次排查dns解析、防火墙拦截、企业级网络限制，并修正dns配置及刷新缓存。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
百度一镜数字人连接超时错误，通常表现为启动后卡在“正在加载数字人”界面、控制台报错connection timeout或net::ERR_CONNECTION_TIMED_OUT，本质是客户端无法在限定时间内完成与百度一镜服务端的TCP三次握手或TLS协商。这类问题90%以上与本地网络策略强相关，而非数字人平台本身故障。
确认是否为DNS解析失败
第一步：打开命令提示符（Windows）或终端（macOS/Linux），执行：
nslookup api.yijing.baidu.com
若返回结果中Server:指向本地路由器或ISP DNS，且Address:为空或显示*** server can't find，说明DNS解析已中断——此时即使网络连通，域名也无法转为IP，必然超时。
第二步：立即换用公共DNS验证，执行：
nslookup api.yijing.baidu.com 8.8.8.8
若该命令能快速返回有效IP（如110.242.68.66类百度系地址），则【DNS被劫持或污染】是主因，必须切换DNS设置，不能依赖系统默认。
临时绕过防火墙测试连通性
方法一：使用curl强制跳过系统代理与防火墙规则
curl -v --connect-timeout 10 https://api.yijing.baidu.com/v1/health
若返回HTTP/2 200且含{"status":"ok"}，说明应用层通信正常，问题锁定在浏览器或SDK运行环境的防火墙策略；若报Failed to connect或卡在Trying xxx.xxx.xxx.xxx...，则本地防火墙或杀毒软件正在拦截 outbound HTTPS 流量。
方法二：Windows下快速禁用防火墙（仅测试用）
以管理员身份运行PowerShell → 输入：
Set-NetFirewallProfile -Profile Domain,Private,Public -Enabled False
注意：执行后无需重启，立即生效。测试完毕务必恢复：
Set-NetFirewallProfile -Profile Domain,Private,Public -Enabled True
修正DNS配置并刷新缓存
① Windows用户：
进入“控制面板 → 网络和 Internet → 网络和共享中心 → 更改适配器设置” → 右键当前连接的网卡 → “属性” → 双击“Internet 协议版本 4 (TCP/IPv4)” → 选择“使用下面的DNS服务器地址” → 填入：
首选DNS服务器：114.114.114.114
备用DNS服务器：8.8.8.8
② macOS用户：
系统设置 → 网络 → 选中当前连接 → 详细信息 → DNS → 点击“+”号添加两行：
114.114.114.114
8.8.8.8
③ 执行强制刷新：
Windows：ipconfig /flushdns
macOS：sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
Linux（systemd-resolved）：sudo systemd-resolve --flush-caches
这一步做完，DNS缓存清空，新配置生效，后续所有域名请求将走你指定的可信DNS节点，不再受运营商劫持影响。
检查企业级网络限制
若身处公司内网或教育网环境，直接ping api.yijing.baidu.com可能显示超时，但nslookup却能返回IP——这说明DNS解析未被阻断，但出站443端口被安全设备（如下一代防火墙NGFW、上网行为管理器）深度检测后主动重置连接。
验证方式：在浏览器地址栏输入 https://api.yijing.baidu.com/v1/health ，若页面显示ERR_CONNECTION_RESET或空白，而curl -v同样卡在TLS handshake阶段，则【企业防火墙策略禁止访问AI类SaaS API】可能性极高。此时需联系IT部门开通白名单，域名必须包含yijing.baidu.com及其子域，协议必须允许TLS 1.2+，不能仅放行HTTP。
