# 主数据推送/分发数据问题排查指南
# 排查指南详细说明
通用前置检查：
- 确认版本：MDM 7.3.0
- 确认服务状态：MDM后端服务正常运行
- 检查网络连通性：MDM服务器与下游订阅者服务网络互通
- 查看推送日志：通过“订阅日志”查看详细错误信息
- 查阅补丁列表：主数据7.3补丁列表 (opens new window)
# 场景一：订阅者配置异常
说明：订阅者是数据推送的目标系统，需在“订阅者系统”中正确配置。
问题现象：
- 新增订阅者时保存失败
- 测试连接失败
- 订阅者类型选择后，配置项显示不全
- 报文校验配置不生效
- 删除订阅者时提示“有订阅配置无法删除”
排查步骤：
第一步：排除产品BUG
- 操作：在MDM官方补丁列表中搜索关键词
订阅者、测试连接 - 相关补丁：
MDM_7.3_UI_20260202_P1（修复编辑订阅系统，报文配置选择系统默认后提交再查看还是忽略问题）MDM_7.3_SERVER_20260105_P1（修复删除数据订阅者导致血缘图加载错误）
- 解决方案：若找到描述匹配的补丁，则申请并应用
- 操作：在MDM官方补丁列表中搜索关键词
第二步：根据问题现象排查
现象：新增订阅者保存失败
- 排查项：系统名称、订阅者类型等必填项是否已填写
- 排查项：根据所选类型检查对应配置项是否完整：
- 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
- 配置说明：支持五种校验方式
现象：订阅者无法删除
- 排查项：该订阅者是否已被订阅配置引用
- 解决方案：先删除引用该订阅者的订阅配置，再删除订阅者
# 场景二：订阅配置异常
说明：订阅配置定义了哪个模型的哪些数据，以何种方式推送给哪个订阅者。
问题现象：
- 新增订阅配置时保存失败
- 推送方式选择后，相关配置项显示不全
- 行列权限配置后不生效
- 字段别名配置无效
- 通知配置保存失败
排查步骤：
第一步：排除产品BUG
- 操作：搜索关键词
订阅配置、推送方式、行列权限 - 相关补丁：
MDM_7.3_UI_20251103_P1（修复数据推送配置保存错误——JSON报文参数错误）MDM_7.3_ALL_20251119_P1（修复数据订阅时，已配置的行权限未能生效）MDM_7.3_UI_20251103_P2（修复模型字段订阅配置字段过多遗漏最后一行字段）
- 解决方案：若找到描述匹配的补丁，则申请并应用
- 操作：搜索关键词
第二步：根据问题现象排查
现象：订阅配置保存失败
- 排查项：数据模型、订阅系统、推送方式等必填项是否已填写
- 排查项：列权限是否至少选择了一个字段
- 排查项：浏览器控制台是否有JS报错
- 解决方案：
- 补充完整必填项信息
- 至少选择一个推送字段
- 清理浏览器缓存后重试
现象：推送方式配置异常
- 推送方式说明：
- 手动推送：在数据维护列表手动选择数据推送
- 自动推送：按时间周期自动推送，需配置：
- 任务开始时间、任务结束时间
- 数据开始时间
- 单次推送限制、步长时间
- 重试策略、重试等待时间
- 实时推送：数据发布/禁用/启用/归档时触发
- 排查项：选择自动推送时，相关参数是否完整配置
- 解决方案：完整配置自动推送所需参数
- 推送方式说明：
现象：行列权限不生效
- 排查项：列权限是否勾选了需要推送的字段
- 排查项：行权限配置的过滤条件是否正确（如
city=shanghai） - 排查项：字段别名配置是否正确（影响报文中的字段名）
- 解决方案：
- 重新勾选列权限
- 修正行权限过滤条件
- 申请补丁
MDM_7.3_ALL_20251119_P1
现象：字段别名无效
- 排查项：别名配置格式是否正确
- 排查项：别名是否与目标系统期望的字段名一致
- 解决方案：修正别名配置，示例：字段
city别名设置为location，报文变化{"city":"shanghai"}变为{"location":"shanghai"}
# 场景三：推送执行异常
问题现象：
- 手动推送时，选择数据后点击推送无响应
- 自动推送未按预期时间执行
- 实时推送未触发
- 推送日志中记录失败
- 下游系统收不到推送数据
排查步骤：
第一步：排除产品BUG
- 操作：搜索关键词
推送、执行、触发 - 相关补丁：
MDM_7.3_UI_20251023_P1（解决数据维护推送，下游系统接口超过10条不显示问题）MDM_7.3_SERVER_20251013_P1（修复订阅下游从模型数据丢失问题）
- 解决方案：若找到描述匹配的补丁，则申请并应用
- 操作：搜索关键词
第二步：根据问题现象排查
现象：手动推送无响应
- 排查项：是否已选择要推送的数据
- 排查项：选择的订阅系统是否已配置且测试连接成功
- 排查项：浏览器控制台是否有JS报错
- 排查项：推送的数据量是否过大（超过10条时需申请补丁）
- 解决方案：
- 至少选择一条数据
- 确保订阅者配置正确
- 申请补丁
MDM_7.3_UI_20251023_P1
现象：自动推送未执行
- 排查项：订阅配置中“推送方式”是否选择为“自动推送”
- 排查项：任务开始时间、结束时间设置是否正确
- 排查项：数据开始时间是否早于当前时间
- 排查项：查看推送日志，确认是否有调度记录
- 解决方案：
- 修正时间参数配置
- 确保任务在有效时间范围内
现象：实时推送未触发
- 排查项：订阅配置中“推送方式”是否选择为“实时推送”
- 排查项：对数据执行的操作是否触发了推送（发布/禁用/启用/归档）
- 排查项：查看推送日志，确认是否有触发记录
- 解决方案：
- 确认推送方式选择正确
- 执行正确的数据操作触发推送
现象：推送日志记录失败
- 排查项：查看日志详情，获取具体错误信息
- 排查项：检查下游系统服务是否正常
- 排查项：网络是否连通
- 排查项：报文校验配置是否与下游系统返回匹配
- 解决方案：
- 根据错误信息调整配置
- 确保下游服务可用
- 修正报文校验配置
# 场景四：推送数据内容异常
问题现象：
- 推送的数据字段缺失
- 推送的数据被行权限过滤掉
- 主子表数据推送时，子表数据丢失
- 推送的报文格式与预期不符
- 字段值显示为编码而非名称
排查步骤：
第一步：排除产品BUG
- 操作：搜索关键词
推送数据、字段缺失、子表丢失 - 相关补丁：
MDM_7.3_SERVER_20251013_P1（修复订阅下游从模型数据丢失问题）MDM_7.3_ALL_20251119_P1（修复数据订阅时，已配置的行权限未能生效）MDM_7.3_UI_20251103_P2（修复模型字段订阅配置字段过多遗漏最后一行字段）
- 解决方案：若找到描述匹配的补丁，则申请并应用
- 操作：搜索关键词
第二步：根据问题现象排查
现象：推送字段缺失
- 排查项：订阅配置中的“列权限”是否勾选了所有需要推送的字段
- 排查项：字段过多时，最后一行字段是否被遗漏
- 解决方案：
- 在列权限中重新勾选所有需要推送的字段
- 申请补丁
MDM_7.3_UI_20251103_P2
现象：数据被行权限过滤
- 排查项：订阅配置中的“行权限”是否配置了过滤条件
- 排查项：过滤条件是否正确（如
city=shanghai） - 排查项：被过滤的数据是否满足行权限条件
- 解决方案：
- 调整行权限配置
- 如不需要过滤，清空行权限配置
- 申请补丁
MDM_7.3_ALL_20251119_P1
现象：子表数据丢失
- 排查项：主子表模型推送时，列权限中是否选择了子表字段
- 排查项：子表数据是否存在
- 排查项：子表数据推送时是否存在主键冲突或关联key丢失问题
- 解决方案：
- 在列权限中勾选子表字段
- 申请补丁
MDM_7.3_SERVER_20251013_P1
现象：报文格式不符
- 排查项：可在订阅配置“行列权限”标签页右上角点击“查看报文”预览推送格式
- 排查项：字段别名配置是否正确
- 解决方案：
- 根据预览报文调整下游系统解析逻辑
- 修正字段别名配置
# 场景五：推送日志/重发异常
问题现象：
- 推送日志页面无数据
- 日志列表显示不全或无法翻页
- 重发推送失败
- 删除日志失败
- 无法查看日志详情
排查步骤：
第一步：排除产品BUG
- 操作：搜索关键词
推送日志、重发、日志详情 - 相关补丁：
MDM_7.3_UI_20251023_P1（解决下游系统接口超过10条不显示问题）MDM_7.3_SERVER_20260128_P1（修复作业流实例问题数据查询未根据指定实例id查询）
- 解决方案：若找到描述匹配的补丁，则申请并应用
- 操作：搜索关键词
第二步：根据问题现象排查
现象：日志页面无数据
- 排查项：是否有推送任务执行过
- 排查项：筛选条件是否限制了结果
- 解决方案：
- 执行一次手动推送产生日志
- 重置筛选条件
现象：重发失败
- 排查项：勾选需要重发的日志，点击“重发”
- 排查项：下游系统服务是否正常
- 排查项：原始推送的数据是否还存在（未被删除）
- 解决方案：
- 确保下游服务可用
- 确认数据未被删除
现象：无法查看日志详情
- 排查项：点击日志右侧的“查看详情”按钮
- 解决方案：应弹出推送内容详情，如无法弹出检查浏览器控制台
现象：无法查看订阅者详情
- 排查项：在日志详情页点击“订阅系统”
- 解决方案：应弹出订阅者详情信息
# 场景六：多节点推送异常
问题现象：
- 多节点部署环境下，下游系统收到重复推送
- 同一数据被多个节点同时推送
- 推送任务被多个节点争抢执行
排查步骤：
第一步：排除产品BUG
- 操作：搜索关键词
多节点、重复推送、分布式锁 - 相关补丁：目前无直接相关补丁
- 解决方案：如确认是产品缺陷，通过AME+发起工单反馈
- 操作：搜索关键词
第二步：根据问题现象排查
- 现象：重复推送
- 排查项：多节点部署时，是否配置了数据推送的分布式锁
- 解决方案：
- 参考文档配置多节点推送：
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
- 参考文档配置多节点推送：
- 现象：重复推送