# 微协同常见问题排查

# 消息问题

# 一、收不到消息

# 1.排查是否OA后台配置有问题造成接收不到消息

OA近期是否更改对外域名?

若更改对外域名请判断是否按照此修改OA对外域名文档 (opens new window)进行修改

集团管理员是否关闭了PC端在线发送消息

具体配置见下图 v8.1-飞书消息-PC端在线发送消息 配置见下图

仅某类消息(非第三方消息)接收不到,或某单位、某员工收不到消息

此时分别检查集团、单位、个人的消息配置集团 集团配置位置如图 注意左下角配置项:集团消息配置是否能更改单位消息配置 单位配置位置如图 注意左下角配置项:是否允许个人单独进行消息配置 个人配置位置如图 这三个配置的优先级为:个人>单位>集团

# 2.排查是否OA端运维配置有问题造成接收不到消息

OA服务器位于内网,是否配置了反向代理?

配置了反向代理,检查http中是否配置允许带下划线的属性

近期是否因为护网行动等原因关闭服务器网络端口?

重点检查443端口、80端口

# 3.排查是否第三方应用后台配置有问题造成接收不到消息

检查钉钉|飞书应用的IP白名单配置

去掉IP白名单的填写

企业微信及公众号检查是否开启了消息免打扰

# 二、消息重复

# OA是否有测试环境?

若测试环境直接复制的正式环境数据库,停用测试环境的微协同

# 部分人员收到重复消息?

上报bug单,研发处理

# 同步问题

# 一、组织架构同步失败

# partyId不符合树形结构

上报bug单,有补丁包

# 已达企业人数上线

第三方组织架构人员扩容

# 其他问题

上报bug单,研发排查

# 二、组织监听同步失败

# 部门名称修改失败

不可修改最顶层名称

# 人员离职、停用、删除人员未同步到第三方

有同步失败日志记录的先排查失败记录,失败记录未明确记载或记录了原因但是不知道怎么处理的 上报bug单,研发排查

# OA后台修改人员信息未同步到第三方

手机号、邮箱在用户进入企业微信后不可再修改,此时请保持OA中手机号与邮箱与企业微信的一致,若不一致会导致其他信息修改同步也失效 有同步失败日志记录的先排查失败记录,失败记录未明确记载或记录了原因但是不知道怎么处理的 上报bug单,研发排查

# OA后台新增人员未同步到第三方

有同步失败日志记录的先排查失败记录 失败记录未明确记载或记录了原因但是不知道怎么处理的 上报bug单,研发排查

# 登录问题

企业微信绑定提示非法参数,请重新绑定

非法参数是企业微信那边没有识别到人员信息导致的,清理微信缓存或退出微信,重新登录

登录后会自动掉线

多为OA服务器缓存有问题,检查服务器内存、磁盘占用情况 上报bug单,研发排查

登陆后提示userId not found

企业微信 & 服务号 & welink & 公有云钉钉 截图上报bug单,研发处理 飞书 & 私有云钉钉 见链接

钉钉点击微协同应用提示:无权查看此页面

根据此链接内容 (opens new window)重新检查配置,应用的IP白名单不要填写

钉钉点击微协同应用报错

根据此链接内容 (opens new window)重新检查配置,应用的IP白名单不要填写

# 企业微信问题

企业微信绑定菜单后在微信的企业公众号中打开菜单后是聊天窗口,未正常穿透到OA

错误界面如下

调整对应配置:企业微信开放平台打开对应应用,应用主页选择修改,在修改界面勾选在微信插件中始终进入主页

PC端企业微信底导航菜单穿透空白或者提示 “PC端暂不支持移动端的应用”

  1. 穿透空白的检查配置应用的连接是否正确。
  2. PC端暂不支持移动端的应用 的,8.1SP1 之前的版本不支持 PC端企业微信底导航穿透。
  3. 8.1SP1版本 PC端企业微信不支持 底导航设置 “全部应用PC” 菜单,如果设置了,可以出代码补丁包来屏蔽该菜单。
创建人:het
修改人:tanghu