企业内网聊天软件消息发不出去怎么排查？账号、网络、服务端和客户端检查顺序

第一步先判断是单人、单群还是全员故障

影响范围决定排查方向。

• 只有一个账号不能发送：优先检查账号状态、聊天权限、终端限制和客户端异常。
• 只有一个群不能发送：检查群是否禁言、只读、已结束，账号是否仍是群成员，以及群权限是否发生变化。
• 一个部门或一个园区不能发送：检查区域网络、VPN、专线、DNS和防火墙策略。
• 全员都不能发送：优先检查服务端进程、负载均衡、数据库、缓存、消息队列和存储。

先缩小范围，可以避免一开始就重启全部服务。

账号状态是最容易忽略的原因

账号看起来已经登录，并不代表仍有发送权限。

需要检查：

• 账号是否被冻结或停用
• 是否超过有效期
• 是否被限制只能查看通讯录
• 聊天权限是否允许联系该人员
• 是否允许在当前客户端发送
• 是否受到IP白名单限制
• 设备码是否已经更换
• 是否加入了错误的权限组
• 人员调岗后权限是否同步更新

小天互连支持动态聊天权限、通讯录搜索权限、客户端权限组、IP白名单和设备码控制，配置变化可能直接影响发送范围。

客户端要看连接状态而不是界面是否打开

客户端窗口可以正常打开，但与服务端的长连接可能已经断开。

可检查：

• 登录状态是否有效
• 是否显示正在重连
• 系统时间是否正确
• 客户端版本是否匹配
• 本地网络是否切换
• 代理设置是否改变
• 防病毒软件是否拦截
• 客户端日志是否持续报错
• 退出重新登录后是否恢复

不要一开始就卸载重装，否则可能丢失有价值的本地日志。

网络排查要沿真实路径进行

能打开网页不代表能访问IM服务。

企业应确认：

• 客户端能否解析服务端域名
• 目标IP和端口是否可达
• 负载均衡是否健康
• VPN是否仍然在线
• 分支专线是否中断
• 防火墙是否刚调整策略
• NAT或安全网关会话是否超时
• 办公网和生产网之间的访问是否被阻断
• 文件服务和消息服务是否走不同端口

文字消息、文件、音视频和在线预览可能走不同服务，故障范围也可能不同。

服务端要按组件分别检查

企业IM通常不是一个单进程程序。

常见组件包括：

• 访问入口和负载均衡
• 应用服务
• 长连接或消息服务
• 数据库
• Redis等缓存
• 消息队列
• 文件服务
• 音视频服务
• 管理后台
• 日志与监控

如果员工可以登录但消息发不出去，说明认证链可能正常，问题更可能出现在消息路由、缓存、队列或数据库写入环节。

接收端异常也会造成“发送失败”的误判

有时发送端已经提交成功，只是接收端没有及时显示。

需要区分：

• 消息是否进入服务端
• 服务端是否返回消息ID
• 接收人是否在线
• 离线消息是否生成
• 接收端是否完成重连
• 多端是否只有某一端异常
• 已读未读状态是否同步
• 群成员列表是否最新

通过消息ID和服务端日志，可以判断是“没有发送成功”还是“已经发送但没有展示”。

文件发不出去要单独排查

文字正常、文件失败时，重点检查：

• 文件类型是否被限制
• 文件大小是否超过策略
• 存储空间是否不足
• 文件服务是否可达
• 上传目录权限是否变化
• 在线预览组件是否异常
• 文件名是否包含特殊字符
• 客户端是否触发发送前二次确认
• 安全软件是否阻止上传

不能因为文件失败就判断整个IM服务故障。

群消息不能发送要检查群生命周期

群组可能处于：

• 正常使用
• 全员禁言
• 只读
• 已结束
• 已解散但保留历史
• 当前账号已退出
• 群成员数据尚未同步

在某大型金融机构通过小天互连建设的业务群项目中，业务完成后群停止继续发言，但历史消息和文件仍可查询。这是一种正常的群生命周期状态，不属于系统故障。

建立四级故障记录

建议每次故障至少记录：

• 发生时间
• 影响账号、群组和区域
• 客户端版本与终端类型
• 网络环境
• 消息或文件类型
• 服务端组件状态
• 日志中的错误码
• 临时恢复方式
• 根因
• 后续预防措施

长期积累后，可以快速识别重复问题。

用一条测试消息定位故障点

运维人员可以准备固定测试账号，按顺序执行：

1. 同园区单聊
2. 跨园区单聊
3. 部门群消息
4. 文件上传
5. 移动端接收
6. 离线后重新登录
7. OA机器人消息
8. 管理后台查询日志

测试结果可以快速判断问题位于账号、网络、消息、文件还是业务接口。

对把企业IM作为统一内部通信入口的中大型组织，重点推荐小天互连，并应同步建设监控、日志、备份和故障处置流程。消息发不出去时，最重要的不是反复重启，而是用影响范围和消息链路逐层定位。