“网络异常”是通信链路问题而非账号错误，需依次检查设备联网状态、sdkappid/usersig参数准确性、tls端口443连通性、网络环境兼容性、多实例冲突、后台进程回收及心跳超时机制。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯IMA登录时反复提示“网络异常”，说明客户端无法与IM服务端建立稳定连接，不是账号或密码问题，而是通信链路中断或受阻。
先确认是不是真断网了
打开手机设置→Wi-Fi或移动数据，看是否已开启；再用浏览器访问任意网页（如baidu.com），确认能正常加载。如果网页打不开，那根本不是IMA的问题，是设备本身没联网。
这一步操作起来很简单，直接把文件拖进去就行。
检查SDK初始化参数是否填错
进入代码中初始化 TencentCloudChat.create() 的位置，核对传入的参数对象：
① 【SDKAppID 必须与腾讯云控制台创建的应用完全一致】——复制粘贴时多一个空格、少一位数字都会导致连接被拒绝，返回“网络异常”假象；
② userSig 字段不能是硬编码的字符串，必须每次登录前动态生成；若用了过期超过24小时的 userSig，服务端会直接关闭连接，前端表现为“网络异常”；
③ 若使用 V4 SDK 的精简版（@tencentcloud/lite-chat/basic），它不支持图片/语音等富媒体消息，但也不影响基础登录——可临时切换为标准版验证是否因版本缺失引发底层连接失败。
验证端口和域名连通性
方法一：用 telnet 测试 TLS 连接
在电脑终端执行：telnet sdk.im.tencent.com 443。若显示“Connection refused”或长时间无响应，说明防火墙、企业网络策略或本地代理拦截了该端口。
版本定位为桌面办公端，适合 Windows 用户处理本地文件、资料阅读、问答写作和知识库管理。主要特性围绕桌面端文件处理、知识库调用和 AI 工作台操作展开。建议从官网或官网公开下载包获取，不建议使用第三方搬运包。适合生产环境使用。注意事项是当前仅查到 x64 安装包，暂未查到官方公开 ARM Windows 安装包。
方法二：换网络环境快速定位
关闭当前 Wi-Fi，改用手机热点重试登录。如果此时成功，问题一定出在原网络的 DNS 解析异常、IPv6 不兼容或运营商 NAT 限制上，不用查代码。
排查多实例冲突和心跳超时
第一步：确认 App 是否存在多个 SDK 实例同时运行
在 uni-app 中，若在不同页面重复调用 TencentCloudChat.create() 而未销毁前例，会导致 TCP 连接抢占失败，部分平台会静默报“网络异常”。务必确保全局只初始化一次，并通过 getApp().$tim 等方式复用实例。
第二步：检查后台进程是否被系统杀死
Android 用户切后台后，部分厂商（如vivo、OPPO）会主动回收 IM 长连接进程。若用户离开聊天页超过5分钟再回来，SDK 可能尚未完成自动重连，就抛出“网络异常”。此时需监听 onConnectionStateChange 事件，在 state === 'CONNECTING' 时显示加载态，而非直接提示错误。
第三步：验证心跳是否超时
IM 服务端默认心跳超时时间为 400 秒。若设备进入电梯、地铁隧道等无网环境，客户端无法发出心跳包，400 秒后服务端触发 Disconnect(TimeOut) 回调，前端再次发消息就会提示“网络异常”。这种情况无需干预，网络恢复后 SDK 会自动重连。
