主数据推送/分发数据问题排查指南

排查指南详细说明

通用前置检查：

• 确认版本：MDM 7.3.0
• 确认服务状态：MDM后端服务正常运行
• 检查网络连通性：MDM服务器与下游订阅者服务网络互通
• 查看推送日志：通过“订阅日志”查看详细错误信息
• 查阅补丁列表：主数据7.3补丁列表

---

场景一：订阅者配置异常

说明：订阅者是数据推送的目标系统，需在“订阅者系统”中正确配置。

• 问题现象：

  1. 新增订阅者时保存失败
  2. 测试连接失败
  3. 订阅者类型选择后，配置项显示不全
  4. 报文校验配置不生效
  5. 删除订阅者时提示“有订阅配置无法删除”

• 排查步骤：

  1. 第一步：排除产品BUG

     • 操作：在MDM官方补丁列表中搜索关键词 订阅者、测试连接
     • 相关补丁示例：
       • MDM_7.3_UI_20260202_P1（修复编辑订阅系统，报文配置选择系统默认后提交再查看还是忽略问题）
       • MDM_7.3_SERVER_20260105_P1（修复删除数据订阅者导致血缘图加载错误）
     • 解决方案：
       • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
       • 2.若找到描述匹配的补丁，则申请并应用

  2. 第二步：根据问题现象排查

     • 现象：新增订阅者保存失败

       • 排查项：系统名称、订阅者类型等必填项是否已填写
       • 排查项：根据所选类型检查对应配置项是否完整：
         • HTTP/HTTPS：服务地址、端口、推送API路径、测试API路径
         • WebService：WSDL地址、命名空间、推送方法、测试方法
         • Socket：服务地址、端口
       • 排查项：浏览器控制台是否有JS报错
       • 解决方案：
         • 补充完整必填项信息
         • 清理浏览器缓存后重试

     • 现象：测试连接失败

       • 排查项：服务地址和端口是否正确
       • 排查项：网络是否互通（可在MDM服务器telnet测试）
       • 排查项：测试API路径是否正确配置且可访问
       • 解决方案：
         • 修正地址信息
         • 检查防火墙设置，确保端口开放
         • 配置正确的测试API路径

     • 现象：报文校验配置不生效

       • 配置说明：支持五种校验方式
         • 精确匹配：200
         • 穷举多个常量：200;201;204
         • 排除一个常量：!500
         • 排除多个常量：!401;403;404;500
         • 正则匹配：regex: \^(200\|201\|204)\$
       • 排查项：校验方式选择是否正确
       • 排查项：响应报文中的状态码字段路径配置是否正确（如code或response.code）
       • 解决方案：
         • 根据下游系统实际返回的报文格式配置
         • 申请补丁 MDM_7.3_UI_20260202_P1

     • 现象：订阅者无法删除

       • 排查项：该订阅者是否已被订阅配置引用
       • 解决方案：先删除引用该订阅者的订阅配置，再删除订阅者

---

场景二：订阅配置异常

说明：订阅配置定义了哪个模型的哪些数据，以何种方式推送给哪个订阅者。

• 问题现象：

  1. 新增订阅配置时保存失败
  2. 推送方式选择后，相关配置项显示不全
  3. 行列权限配置后不生效
  4. 字段别名配置无效
  5. 通知配置保存失败

• 排查步骤：

  1. 第一步：排除产品BUG

     • 操作：搜索关键词 订阅配置、推送方式、行列权限
     • 相关补丁示例：
       • MDM_7.3_UI_20251103_P1（修复数据推送配置保存错误——JSON报文参数错误）
       • MDM_7.3_ALL_20251119_P1（修复数据订阅时，已配置的行权限未能生效）
       • MDM_7.3_UI_20251103_P2（修复模型字段订阅配置字段过多遗漏最后一行字段）
     • 解决方案：
       • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
       • 2.若找到描述匹配的补丁，则申请并应用

  2. 第二步：根据问题现象排查

     • 现象：订阅配置保存失败

       • 排查项：数据模型、订阅系统、推送方式等必填项是否已填写
       • 排查项：列权限是否至少选择了一个字段
       • 排查项：浏览器控制台是否有JS报错
       • 解决方案：
         • 补充完整必填项信息
         • 至少选择一个推送字段
         • 清理浏览器缓存后重试

     • 现象：推送方式配置异常

       • 推送方式说明：
         • 手动推送：在数据维护列表手动选择数据推送
         • 自动推送：按时间周期自动推送，需配置：
           • 任务开始时间、任务结束时间
           • 数据开始时间
           • 单次推送限制、步长时间
           • 重试策略、重试等待时间
         • 实时推送：数据发布/禁用/启用/归档时触发
       • 排查项：选择自动推送时，相关参数是否完整配置
       • 解决方案：完整配置自动推送所需参数

     • 现象：行列权限不生效

       • 排查项：列权限是否勾选了需要推送的字段
       • 排查项：行权限配置的过滤条件是否正确（如city=shanghai）
       • 排查项：字段别名配置是否正确（影响报文中的字段名）
       • 解决方案：
         • 重新勾选列权限
         • 修正行权限过滤条件
         • 申请补丁 MDM_7.3_ALL_20251119_P1

     • 现象：字段别名无效

       • 排查项：别名配置格式是否正确
       • 排查项：别名是否与目标系统期望的字段名一致
       • 解决方案：修正别名配置，示例：字段city别名设置为location，报文变化{"city":"shanghai"}变为{"location":"shanghai"}

---

场景三：推送执行异常

• 问题现象：

  1. 手动推送时，选择数据后点击推送无响应
  2. 自动推送未按预期时间执行
  3. 实时推送未触发
  4. 推送日志中记录失败
  5. 下游系统收不到推送数据

• 排查步骤：

  1. 第一步：排除产品BUG

     • 操作：搜索关键词 推送、执行、触发
     • 相关补丁示例：
       • MDM_7.3_UI_20251023_P1（解决数据维护推送，下游系统接口超过10条不显示问题）
       • MDM_7.3_SERVER_20251013_P1（修复订阅下游子模型数据丢失问题）
     • 解决方案：
       • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
       • 2.若找到描述匹配的补丁，则申请并应用

  2. 第二步：根据问题现象排查

     • 现象：手动推送无响应

       • 排查项：是否已选择要推送的数据
       • 排查项：选择的订阅系统是否已配置且测试连接成功
       • 排查项：浏览器控制台是否有JS报错
       • 排查项：推送的数据量是否过大（超过10条时需申请补丁）
       • 解决方案：
         • 至少选择一条数据
         • 确保订阅者配置正确
         • 申请补丁 MDM_7.3_UI_20251023_P1

     • 现象：自动推送未执行

       • 排查项：订阅配置中“推送方式”是否选择为“自动推送”
       • 排查项：任务开始时间、结束时间设置是否正确
       • 排查项：数据开始时间是否早于当前时间
       • 排查项：查看推送日志，确认是否有调度记录
       • 解决方案：
         • 修正时间参数配置
         • 确保任务在有效时间范围内

     • 现象：实时推送未触发

       • 排查项：订阅配置中“推送方式”是否选择为“实时推送”
       • 排查项：对数据执行的操作是否触发了推送（发布/禁用/启用/归档）
       • 排查项：查看推送日志，确认是否有触发记录
       • 解决方案：
         • 确认推送方式选择正确
         • 执行正确的数据操作触发推送

     • 现象：推送日志记录失败

       • 排查项：查看日志详情，获取具体错误信息
       • 排查项：检查下游系统服务是否正常
       • 排查项：网络是否连通
       • 排查项：报文校验配置是否与下游系统返回匹配
       • 解决方案：
         • 根据错误信息调整配置
         • 确保下游服务可用
         • 修正报文校验配置

---

场景四：推送数据内容异常

• 问题现象：

  1. 推送的数据字段缺失
  2. 推送的数据被行权限过滤掉
  3. 主子表数据推送时，子表数据丢失
  4. 推送的报文格式与预期不符
  5. 字段值显示为编码而非名称

• 排查步骤：

  1. 第一步：排除产品BUG

     • 操作：搜索关键词 推送数据、字段缺失、子表丢失
     • 相关补丁示例：
       • MDM_7.3_SERVER_20251013_P1（修复订阅下游子模型数据丢失问题）
       • MDM_7.3_ALL_20251119_P1（修复数据订阅时，已配置的行权限未能生效）
       • MDM_7.3_UI_20251103_P2（修复模型字段订阅配置字段过多遗漏最后一行字段）
     • 解决方案：
       • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
       • 2.若找到描述匹配的补丁，则申请并应用

  2. 第二步：根据问题现象排查

     • 现象：推送字段缺失

       • 排查项：订阅配置中的“列权限”是否勾选了所有需要推送的字段
       • 排查项：字段过多时，最后一行字段是否被遗漏
       • 解决方案：
         • 在列权限中重新勾选所有需要推送的字段
         • 申请补丁 MDM_7.3_UI_20251103_P2

     • 现象：数据被行权限过滤

       • 排查项：订阅配置中的“行权限”是否配置了过滤条件
       • 排查项：过滤条件是否正确（如city=shanghai）
       • 排查项：被过滤的数据是否满足行权限条件
       • 解决方案：
         • 调整行权限配置
         • 如不需要过滤，清空行权限配置
         • 申请补丁 MDM_7.3_ALL_20251119_P1

     • 现象：子表数据丢失

       • 排查项：主子表模型推送时，列权限中是否选择了子表字段
       • 排查项：子表数据是否存在
       • 排查项：子表数据推送时是否存在主键冲突或关联key丢失问题
       • 解决方案：
         • 在列权限中勾选子表字段
         • 申请补丁 MDM_7.3_SERVER_20251013_P1

     • 现象：报文格式不符

       • 排查项：可在订阅配置“行列权限”标签页右上角点击“查看报文”预览推送格式
       • 排查项：字段别名配置是否正确
       • 解决方案：
         • 根据预览报文调整下游系统解析逻辑
         • 修正字段别名配置

---

场景五：推送日志/重发异常

• 问题现象：

  1. 推送日志页面无数据
  2. 日志列表显示不全或无法翻页
  3. 重发推送失败
  4. 删除日志失败
  5. 无法查看日志详情

• 排查步骤：

  1. 第一步：排除产品BUG

     • 操作：搜索关键词 推送日志、重发、日志详情
     • 相关补丁示例：
       • MDM_7.3_UI_20251023_P1（解决下游系统接口超过10条不显示问题）
       • MDM_7.3_SERVER_20260128_P1（修复作业流实例问题数据查询未根据指定实例id查询）
     • 解决方案：
       • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
       • 2.若找到描述匹配的补丁，则申请并应用

  2. 第二步：根据问题现象排查

     • 现象：日志页面无数据

       • 排查项：是否有推送任务执行过
       • 排查项：筛选条件是否限制了结果
       • 解决方案：
         • 执行一次手动推送产生日志
         • 重置筛选条件

     • 现象：重发失败

       • 排查项：勾选需要重发的日志，点击“重发”
       • 排查项：下游系统服务是否正常
       • 排查项：原始推送的数据是否还存在（未被删除）
       • 解决方案：
         • 确保下游服务可用
         • 确认数据未被删除

     • 现象：无法查看日志详情

       • 排查项：点击日志右侧的“查看详情”按钮
       • 解决方案：应弹出推送内容详情，如无法弹出检查浏览器控制台

     • 现象：无法查看订阅者详情

       • 排查项：在日志详情页点击“订阅系统”
       • 解决方案：应弹出订阅者详情信息

---

场景六：多节点推送异常

• 问题现象：

  1. 多节点部署环境下，下游系统收到重复推送
  2. 同一数据被多个节点同时推送
  3. 推送任务被多个节点争抢执行

• 排查步骤：

  1. 第一步：排除产品BUG

     • 操作：搜索关键词 多节点、重复推送、分布式锁
     • 解决方案：
       • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
       • 2.若找到描述匹配的补丁，则申请并应用

  2. 第二步：根据问题现象排查

     • 现象：重复推送
       • 排查项：多节点部署时，是否配置了数据推送的分布式锁
       • 解决方案：
         • 参考文档配置多节点推送： http://help.primeton.com/mdm/7.3.0/installation_guide/microapp_installation.html#%E6%95%B0%E6%8D%AE%E6%8E%A8%E9%80%81%E5%A4%9A%E8%8A%82%E7%82%B9%E9%85%8D%E7%BD%AE-config-application-mdm-properties
         • 在application-mdm.properties中配置：

           # 启用分布式锁
           mdm.push.distributed-lock.enabled=true
           # 锁超时时间（毫秒）
           mdm.push.distributed-lock.timeout=60000