反馈已提交

网络繁忙

移动端集成问题排查手册

  • 文档创建者:Leo.Tsai
  • 历史版本:12
  • 最近更新:Marlon.Zhao 于 2024-05-29
  • 1. 概述

    针对微信、钉钉、飞书、WeLink集成遇到的问题,提供排查手册帮助用户快速定位和解决这些问题。用户也可参考以下文档查找解决方案。

    相关文档链接:

    移动端功能常见问题:移动端功能常见问题及解决方案

    钉钉集成常见问题:钉钉集成常见问题及解决方案

    微信集成常见问题:微信集成常见问题及解决方案

    OA 错误码对照表:OA错误码对照表

    2. 排查思路

    遇到移动端集成相关问题时,可以先按照以下流程图进行排查,如下图所示:

    调试功能请参考:移动端集成调试工具

    3. 功能点逐一排查

    如果按照流程排查仍未解决问题,可以按照具体问题以及功能点进行排查和解决,下面表格中列出一些问题及解决方案。

    3.1 应用管理-服务器地址

    问题描述:

    部署访问报错无法加载。

    解决方案:

    服务器地址不能以 / 结尾,主要是会影响生成链接拼接参数和定时调度推送链接的生成

    可修改单点链接或平台访问地址规避这个问题,服务器地址要以/decision结尾,不能只写http(s)://域名:端口

    3.2 通讯录-同步

    问题描述:

    同步不到用户。

    解决方案:

    可参考:钉钉集成常见问题微信集成常见问题微信钉钉推送/单点/同步失败日志定位

    3.3 插件注册

    问题描述:

    插件过期后更换 lic 仍显示未注册

    解决方案:

    1)确认插件是否是二开定制插件

    2)多个环境进行测试,确认 lic 是否异常(帆软市场异常会导致当时申请的 lic 功能异常)

    3.4 成员管理

    问题描述:

    点击成员管理报错 500。

    解决方案:

    检查 plugins 下是否有多个版本的集成插件,关闭工程删掉多余的插件,保证工程重启后 plugins 下只有要用的版本即可

    3.5 单独登录失败

    解决方案:

    可参考:单点登录失败排查步骤

    3.6 单点后报错

    解决方案:

    钉钉集成常见问题微信集成常见问题

    3.7 推送失败

    解决方案:

    1)同步 JAR 包

    2)可参考:钉钉集成常见问题

    3)Oracle 锁表导致平台定时调度执行异常问题:定时调度快照生成成功,偶尔几个用户的邮件发送失败,用户不确定、用户数量不确定

    修改$ORACLE_HOME/network/admin/sqlnet.ora,添加或者修改成sqlnet.expire_time=0,即关闭 Oracle 的连接状态检测;修改数据连接的连接池属性,最大等待时间设置为50000毫秒;修改定时任务超过时间,ScheduleSettingConfig.taskTimeout再当前值的基础上再加3分钟,即480000毫秒

    3.8 消息接收

    3.8.1 用户收不到消息

    解决方案:

    1)重新手动同步下用户是否解决

    2)用户是否匹配了平台用户

    3)用户匹配的平台用户是否在推送的范围内

    3.8.2 定时任务部分用户收不到消息

    解决方案:

    钉钉集成常见问题微信集成常见问题

    3.8.3 某一个用户收不到消息

    解决方案:

    1)是否为多企业用户,若用户添加两个企业,则更新插件至11.0.62,对应版本处理过多企业同名用户匹配的问题。

    2)在同步通讯录中是否能找到对应用户

    3)用户是否匹配了平台用户

    4)用户匹配的平台用户是否在推送的范围内

    3.9 消息内容

    3.9.1 推送的消息内容字数限制

    解决方案:

    微信钉钉 API 的一些限制

    参考:https://developer.work.weixin.qq.com/document/path/90236

    文本消息:消息内容,最长不超过 2048 个字节,超过将截断

    图文消息:标题,不超过 128 个字节,描述,不超过 512 个字节

    3.9.2 提示找不到模板文件

    解决方案:

    1)检查webroot/WEB-INF/schedule/任务名/时间/对应文件夹下,是否有文件生成

    2,确认是否有两个环境配置了同一个应用,不支持两个工程配置同一个微信/钉钉/飞书/WeLink应用,会相互排挤的,除非是集群的两个子节点

    3)确认是否是集群环境,是的话是否两个节点间的数据没有同步,导致打开模板访问的是未同步数据的节点

    3.9.3 显示内容有问题

    解决方案:

    定时结果在 H5 下显示问题,更新下新自适应插件。

    3.9.4 推送出来的消息,用户权限错乱

    排查步骤:

    检查是否在推送的时间点,有其他同步,ETL取数等事件在同步处理,影响到了

    3.10 参数生效

    问题描述:

    生成单点的模板链接,设置参数不生效 now(),fine_username。

    排查步骤:

    定时调度,设置参数=fine_username不生效,可能导致文件控件无法使用。

    3.11 图文推送

    3.11.1 图文推送的图片封面偶发不显示

    排查步骤:

    1)确认是否是集群环境

    2)集群环境下,见下集群各个节点是否正常,状态服务器文件服务器是否配置,文件缓存是否开启

    3.11.2 图文推送图片收不到

    排查步骤:

    1)检查任务是否配置了图片

    2)将图片重新上传试试


    附件列表


    主题: 移动端应用
    • 有帮助
    • 没帮助
    • 只是浏览
    中文(简体)

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭



    AI

    联系我们
    在线支持
    获取专业技术支持,快速帮助您解决问题
    工作日9:00-12:00,13:30-17:30在线
    页面反馈
    针对当前网页的建议、问题反馈
    售前咨询
    采购需求/获取报价/预约演示
    或拨打: 400-811-8890 转1
    qr
    热线电话
    咨询/故障救援热线:400-811-8890转2
    总裁办24H投诉:17312781526
    提交页面反馈
    仅适用于当前网页的意见收集,帆软产品问题请在 问答板块提问前往服务平台 获取技术支持