主数据模型管理模块问题排查指南

排查指南详细说明

通用前置检查：

• 确认版本：明确是MDM 7.3.0版本。
• 检查基础环境：
  • 清理浏览器缓存，或使用无痕模式重新登录。
  • 确认当前登录用户账号是否具备操作相关模块的权限。
• 查阅补丁列表：优先检索官方已发布的补丁。您可以通过以下链接访问官方补丁列表：
  • MDM 7.3 补丁列表: 主数据7.3补丁列表 (opens new window)

---

场景一：模型配置/发布异常

• 问题现象：

  1. 模型配置（字段、页面、约束等）保存失败或配置内容丢失。
  2. 模型发布失败，或发布后功能与预期不符（如表单加载异常、新增字段不生效）。

• 排查步骤：

  1. 第一步：排除产品BUG。

     • 操作：在官方补丁列表中，搜索关键词 模型、发布、配置、表单、字段。
     • 相关补丁：
       • MDM_7.3_SERVER_20251222_P1（解决模型配置页面启用分组导航报错）
       • MDM_7.3_SERVER_20251204_P1（解决页面配置启用分组导航报错）
       • MDM_7.3_SERVER_20251124_P1（修复通过模板导入的模型，组织机构不显示）
     • 解决方案：若找到描述匹配的补丁，则申请并应用。

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

     • 现象：配置保存失败或丢失

       • 排查项：模型编码、表名、字段编码是否符合数据库规范（不能以数字开头、不能含特殊字符、长度未超限）。表名是否已存在。
       • 排查项：是否多个用户同时在编辑同一模型配置。
       • 解决方案：
         • 修改不符合规范的编码，确保符合命名规则。
         • 避免多人同时编辑同一模型，建议串行操作。

     • 现象：模型发布失败

       • 排查项：模型名称、字段名称等必填项是否已填写完整。
       • 排查项：字段类型、长度设置是否超出数据库支持范围（如单行数据总量过大导致建表失败）。
       • 解决方案：
         • 补充所有必填项信息。
         • 减少字段数量或缩短字段长度，拆分过大的模型。

     • 现象：发布后功能异常

       • 排查项：进入“页面配置”，检查字段绑定的低代码组件类型是否正确（如编码字段是否用了“业务组件-编码”）。
       • 排查项：新增字段是否已在“数据授权”中授予当前用户角色读写权限。
       • 排查项：打开浏览器开发者工具（F12），查看Console或Network页签是否有明确的JS报错或接口请求失败信息。
       • 解决方案：
         • 修正组件类型配置，重新发布模型。
         • 在“数据授权”中为新增字段配置权限。
         • 根据浏览器报错信息调整Nginx转发配置或申请内存扩容。

---

场景二：分类/继承模型异常

• 问题现象：

  1. 继承模型下，子模型数据无法正常维护或展示。
  2. 分类模型配置复杂，子模型绑定预留字段失败或报错。

• 排查步骤：

  1. 第一步：排除产品BUG。

     • 操作：在官方补丁列表中，搜索关键词 分类、继承、根模型、子模型。
     • 相关补丁：
       • MDM_7.3_SERVER_20260120_P2（修复继承模型查询时，错误查询到其他分类下的模型）
       • MDM_7.3_SERVER_20251216_P1（解决分类根模型的子模型数据在修订后消失）
     • 解决方案：若找到描述匹配的补丁，则申请并应用。

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

     • 现象：子模型数据异常

       • 排查项：确认当前使用的是继承模式（参考手册“分类模型”章节）。
       • 排查项：根模型和子模型是否均已成功发布。
       • 解决方案：确保根模型和子模型均为已发布状态，重新发布后再次尝试。

     • 现象：预留字段绑定失败

       • 排查项：子模型中定义的业务字段是否正确绑定了根模型中配置的“预留字段”。
       • 排查项：绑定的预留字段类型（字符串、数值）和长度是否与子模型字段的需求相匹配。
       • 解决方案：
         • 在子模型配置中，将业务字段正确绑定到根模型的预留字段上，并重新发布。
         • 进入“平台配置”->“预留字段配置”，为根模型添加或调整预留字段方案，确保包含所需类型和数量的字段。

---

场景三：模型接口/服务异常

• 问题现象：

  1. 调用模型生成的OpenAPI接口报错（如空指针、找不到数据、数据更新异常）。
  2. 服务注册到ESB失败或状态显示不正确。

• 排查步骤：

  1. 第一步：排除产品BUG。

     • 操作：在官方补丁列表中，搜索关键词 接口、API、服务、注册、调用。
     • 相关补丁：
       • MDM_7.3_SERVER_20251204_P2（优化注册服务提示，单条接口注册前需先执行全量注册）
       • MDM_7.3_ALL_20251119_P1（修复根据系统主键发布业务数据接口报错）
       • MDM_7.3_SERVER_20251103_P1（增强新增接口对默认值的支持）
     • 解决方案：若找到描述匹配的补丁，则申请并应用。

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

     • 现象：接口调用报错

       • 排查项：通过管理门户“服务管理”或Swagger地址，核对请求URL、HTTP方法、请求参数（包括路径参数、查询参数、请求体）的格式是否正确。
       • 排查项：确认调用接口时使用的客户端凭证（x-mdm-client-code/x-mdm-client-secret）是有效的，并且在“服务授权”中已为该客户端授予了对应模型的API调用权限。
       • 排查项：对于POST/PUT请求，检查请求体的JSON结构是否与接口定义一致，特别是主子表数据的嵌套结构。
       • 解决方案：
         • 根据接口文档调整请求参数和报文格式。
         • 在“服务授权”中为客户端配置对应模型的API权限。
         • 使用Swagger页面或Postman等工具进行接口调试，验证正确调用方式。

     • 现象：服务注册失败

       • 排查项：检查application-mdm.properties中mdm.esb.support.afc配置是否正确（使用ESB9.0/iPaaS 9.1.0时需设置为true）。
       • 排查项：确认在ESB平台上已提前注册好相关的域、系统、通道信息。
       • 解决方案：
         • 修正配置文件后重启服务。
         • 先在ESB平台完成域、系统、通道的注册，再执行MDM服务注册操作。
         • 按照补丁说明，先执行一次全量注册，再进行单条接口注册。

---

场景四：模型数据维护异常

• 问题现象：

  1. 业务数据新增、编辑、删除后，前台展示与后台数据不一致（如字典项不显示、子表数据丢失）。
  2. 数据导入/导出失败，或导入数据后校验不通过。

• 排查步骤：

  1. 第一步：排除产品BUG。

     • 操作：在官方补丁列表中，搜索关键词 导入、导出、数据维护、字典、子表。
     • 相关补丁：
       • MDM_7.3_SERVER_20260121_P1（修复数据操作未通过时，未按约束配置的提示信息报错）
       • MDM_7.3_SERVER_20260129_P1（修复存在附件字段时，导入报缺失字段信息）
       • MDM_7.3_ALL_20251020_P1（修复子表引用字典时，数据显示异常）
       • MDM_7.3_UI_20251208_P1（修复子模型字典字段修改后反显失效）
     • 解决方案：若找到描述匹配的补丁，则申请并应用。

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

     • 现象：前台展示与后台数据不一致

       • 排查项：在模型的“页面配置”中，检查相关字段的组件类型（如字典字段是否用了“下拉选择”）、数据来源配置是否正确。
       • 排查项：在“数据授权”中，检查当前用户所属角色是否对该模型及字段拥有正确的读写权限。
       • 排查项：尝试清理浏览器缓存或使用无痕模式重新登录。
       • 解决方案：
         • 重新配置字段组件和数据来源，重新发布模型。
         • 在“数据授权”中为字段配置读权限。
         • 清理浏览器缓存后重新访问。

     • 现象：导入/导出失败

       • 排查项：重新下载导入模板，确认导入的Excel文件未修改模板结构（如列名、顺序、sheet名），并且数据格式（日期、数值）符合要求。对于主子表，确保子表数据在对应的sheet页中。
       • 排查项：若导入失败并提示校验错误，检查模型的“约束配置”（如唯一约束、主键约束）是否与导入数据冲突。
       • 排查项：检查当前用户角色是否具备导入导出功能权限。
       • 解决方案：
         • 重新下载模板，按规范填写数据后重新导入。
         • 临时禁用冲突的约束规则，或调整导入数据以满足约束条件。
         • 在“数据授权”中为角色配置导入导出功能权限。

---

场景五：模型权限/流程异常

• 问题现象：

  1. 为用户授予数据角色后，权限（行列权限、菜单权限）未生效。
  2. 为模型绑定审批流程后，无法发起流程或流程流转异常。

• 排查步骤：

  1. 第一步：排除产品BUG。

     • 操作：在官方补丁列表中，搜索关键词 授权、权限、流程、待办。
     • 相关补丁：
       • MDM_7.3_UI_20260129_P1（修复审批查看设置权限后，字段无法按权限控制隐藏）
       • MDM_7.3_SERVER_20260212_P1（全面适配内部从模型数据维护的行权限）
       • MDM_7.3_ALL_20251119_P1（修复数据订阅时，已配置的行权限未能生效）
       • MDM_7.3_UI_20251112_P1（解决流程配置-流程绑定，新增流程配置报错）
       • MDM_7.3_UI_20251215_P1（优化工作台我的流程跳转，解决404错误）
     • 解决方案：若找到描述匹配的补丁，则申请并应用。

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

     • 现象：权限未生效

       • 排查项：确认授予用户的AFCenter平台角色编码是否以mdm-开头，名称是否以MDM开头。
       • 排查项：在“数据授权”中，检查对应角色的权限配置（列权限必选）是否已完整配置并点击“提交”保存。
       • 排查项：确认用户已成功分配到该平台角色。
       • 解决方案：
         • 创建符合命名规范的角色（编码mdm-开头，名称MDM开头）。
         • 在“数据授权”中，重新为角色配置模型权限，确保列权限已选择并提交。
         • 移除用户角色后重新分配，或等待角色缓存刷新。

     • 现象：流程异常

       • 排查项：在流程绑定时，检查所选流程定义的名称是否以“主数据-”为前缀。
       • 排查项：检查该流程定义中，审批环节（人工活动）的参与者类型和ID命名是否遵循规范（PARTICIPANT_前缀，数据上下文）。
       • 排查项：确认审批参与者（员工/角色）是否正确分配给了对应的审批用户。
       • 解决方案：
         • 在低开中心修改流程定义，确保命名和审批环节配置符合规范（参考手册“开发自定义业务审批流程规范”）。
         • 删除异常流程定义，从基线包重新导入或克隆平台预置流程进行修改。
         • 在流程绑定配置中，为各个审批环节选择正确的参与者。