# 主数据模型配置与数据维护问题排查指南
# 排查指南详细说明
通用前置检查：
- 确认版本：明确是MDM 7.3.0版本。
- 检查基础环境：
- 清理浏览器缓存，或使用无痕模式重新登录。
- 确认浏览器版本兼容性（推荐Chrome、Edge最新版本）。
- 优先使用最新前端补丁：涉及前端展示类问题，优先申请并使用最新的 EOS 8.3.3 AFCenter UI补丁。您可以通过以下链接访问官方补丁列表：
- EOS 8.3.3 前端补丁: EOS8.3.3补丁列表 (opens new window)
- 区分问题类型：
- 模型配置问题：在“管理门户”->“模型管理”->“主数据”->“页面配置”中配置表单时出现的问题。
- 数据维护问题：在“业务门户”->“模型信息”->“数据维护”中操作数据时暴露的问题。
- 查阅MDM补丁列表：您可以通过以下链接访问MDM专用补丁列表：
- MDM 7.3 补丁列表: 主数据7.3补丁列表 (opens new window)
# 场景一：模型配置-低开表单问题
说明：此类问题发生在模型管理的“页面配置”向导页中，属于模型配置阶段的问题，与后续数据维护无直接关系。
问题现象：
- 在“页面配置”中配置字段组件时，组件类型无法修改或保存。
- 字段拖拽调整顺序后，保存不生效。
- 编码字段在表单中未正确显示为编码组件。
- 子模型表单配置后，在预览时无法显示。
排查步骤：
第一步：排除产品BUG。
- 操作：
- 优先申请最新的EOS 8.3.3 AFCenter UI补丁，解决大部分前端展示类问题。
- 在MDM官方补丁列表中，搜索关键词
页面配置、表单、组件、编码。
- 相关补丁：
PLATFORM_8.3.3_AFCENTER_UI_20251219_P1（解决低开页面主数据模型字段显示为空等问题）MDM_7.3_UI_20251208_P1（修复子模型字典字段修改后反显失效）MDM_7.3_UI_20251106_P1（优化组织显示、面包屑等问题）MDM_7.3_UI_20251021_P1（解决约束配置删除非选中行问题）MDM_7.3_UI_20251124_P1（解决子模型过多被按钮遮挡问题）
- 解决方案：若找到描述匹配的补丁，则申请并应用。
- 操作：
第二步：根据问题现象排查。
现象：组件类型无法修改或保存不生效
- 排查项：修改组件类型后，是否点击了“保存”并重新发布了模型。
- 排查项：浏览器控制台是否有JS报错。
- 解决方案：
- 修改组件配置后，需保存并重新发布模型。
- 清理浏览器缓存后重试。
现象：编码字段未显示为编码组件
- 排查项：在“页面配置”中，是否将该字段的组件类型修改为“业务组件-编码”。
- 排查项：是否已在“编码配置”向导页中为该字段配置了编码方案。
- 解决方案：
- 在页面配置中，将字段组件类型修改为“业务组件-编码”。
- 完成编码方案配置后重新发布模型。
- 注意：子模型不支持编码组件，不要在子模型中使用。
现象：子模型表单配置后无法显示
- 排查项：子模型是否已在“字段配置”中正确添加。
- 排查项：子模型的页面配置是否已完成。
- 解决方案：
- 确保子模型已在主模型的“字段配置”中作为子模型添加。
- 完成子模型的页面配置后，重新发布主模型。
# 场景二：数据维护-展示/操作问题
说明：此类问题发生在“业务门户”->“模型信息”->“数据维护”页面，是模型发布后用户在操作数据时遇到的问题，通常与模型配置不当有关，但问题暴露在数据维护阶段。
问题现象：
- 新增、编辑数据时，表单字段显示不全或布局错乱。
- 子表数据无法新增、查看或删除。
- 列表页查询条件不生效，或查询结果与预期不符。
- 数据保存后，前台展示与后台数据不一致（如字典项不显示）。
- 主子表数据维护时，子表数据丢失或无法回显。
排查步骤：
第一步：排除产品BUG。
- 操作：
- 优先申请最新的EOS 8.3.3 AFCenter UI补丁，解决大部分前端展示类问题。
- 在MDM官方补丁列表中，搜索关键词
数据维护、子表、查询、保存、显示。
- 相关补丁：
PLATFORM_8.3.3_AFCENTER_UI_20251219_P1（解决低开页面字段显示为空等问题）MDM_7.3_ALL_20251020_P1（修复子表引用字典时数据显示异常、左树右表查询问题）MDM_7.3_ALL_20250929_P1（修复主子表模型子表字典不回显问题）MDM_7.3_UI_20251205_P1（解决参考数据列表编辑页面显示不全）MDM_7.3_SERVER_20251229_P1（优化between查询容错机制）MDM_7.3_UI_20251208_P1（修复子模型字典字段修改后反显失效）
- 解决方案：若找到描述匹配的补丁，则申请并应用。
- 操作：
第二步：回溯模型配置问题。
现象：表单显示不全或布局错乱
- 排查项：返回“模型管理”->“页面配置”，检查表单布局是否合理，是否有组件被拖动到可视区域外。
- 排查项：检查字段是否被设置为隐藏，但在“数据授权”中未正确配置权限。
- 解决方案：
- 在页面配置中重新调整表单布局，保存并重新发布模型。
- 如需隐藏字段，应在“数据授权”中取消该字段的读权限，而非在页面配置中隐藏。
现象：子表数据异常
- 排查项：返回模型“字段配置”向导页，检查子模型是否已正确添加，关联关系是否正确。
- 排查项：子表的页面配置是否完整。
- 解决方案：
- 修正子模型配置后，重新发布模型。
- 子表数据需在主表编辑状态下进行维护。
现象：查询条件不生效
- 排查项：返回“页面配置”的“默认视图”，检查查询条件的字段配置是否正确。
- 排查项：编码字段作为查询条件时，是否将控件类型设置为“文本框”（常见遗漏点）。
- 解决方案：
- 编码字段查询条件配置：自定义条件 -> 选择编码字段 -> 控件类型选择文本框。
- 重新配置后保存并发布模型。
现象：字典项不显示或显示为编码
- 排查项：返回“页面配置”，检查下拉组件的“数据来源”配置是否正确。
- 排查项：是否已选择“被引用字段”和“显示字段”。
- 解决方案：
- 正确配置数据来源，选择引用字段和显示字段，重新发布模型。
- 申请补丁解决子表字典显示问题。
# 场景三：业务字典/参考数据问题
说明：此类问题涉及字典和参考数据的配置、发布及在表单中的使用，可能同时影响模型配置和数据维护两个阶段。
问题现象：
- 下拉选择字典项时，选项为空或不显示。
- 字典项选择后，保存成功但列表页不显示（显示为编码或空白）。
- 树形字典查询时，面包屑导航显示空白。
- 字典字段的默认值不生效。
- 国际化环境下，字典项未翻译或翻译错误。
排查步骤：
第一步：排除产品BUG。
- 操作：
- 优先申请最新的EOS 8.3.3 AFCenter UI补丁，解决大部分前端展示类问题。
- 在MDM官方补丁列表中，搜索关键词
字典、参考数据、下拉、默认值、国际化。
- 相关补丁：
PLATFORM_8.3.3_AFCENTER_UI_20251107_P1（解决下拉多选默认值问题）PLATFORM_8.3.3_AFCENTER_UI_20251031_P1（EOS前端补丁，配合字典功能使用）MDM_7.3_SERVER_20251103_P1（解决字典过滤、默认值、接口默认值等问题）MDM_7.3_SERVER_20251111_P1（解决树形参考数据面包屑显示不正常）MDM_7.3_ALL_20251020_P1（修复子表引用字典时单元格显示空白）
- 解决方案：若找到描述匹配的补丁，则申请并应用。
- 操作：
第二步：根据问题现象排查。
现象：下拉选项为空
- 排查项：参考数据或业务字典是否已发布，且数据是否已维护。
- 排查项：在模型“页面配置”中，下拉组件的“数据来源”配置是否正确。
- 排查项：对于参考数据，是否已选择“被引用字段”和“显示字段”。
- 解决方案：
- 发布字典/参考数据模型，并维护业务数据。
- 正确配置数据来源，选择引用字段和显示字段，重新发布模型。
现象：选择后不显示（显示为编码）
- 排查项：下拉组件的数据来源配置中，“显示字段”是否已正确选择。
- 排查项：对于子表中的字典字段，是否存在已知的UI显示问题。
- 解决方案：
- 修正显示字段配置，重新发布模型。
- 申请补丁
MDM_7.3_ALL_20251020_P1解决子表字典显示问题。
现象：树形字典面包屑空白
- 排查项：树形字典的父字段配置是否正确。
- 解决方案：申请补丁
MDM_7.3_SERVER_20251111_P1。
现象：默认值不生效
- 排查项：默认值是在“页面配置”中设置，还是在字典模型中设置。
- 解决方案：
- 在“页面配置”中为下拉组件设置默认值。
- 申请补丁
MDM_7.3_SERVER_20251103_P1解决接口调用时的默认值问题。
现象：国际化未翻译
- 排查项：是否已配置国际化资源文件。
- 解决方案：
- 在“页面配置”中使用国际化资源配置，提取中文翻译。
- 如涉及需通过jar文件解决的国际化问题：请通过AME+发起工单，申请获取对应的国际化补丁jar包，放置到
mdm/lib目录下并重启服务。
# 场景四：业务门户/菜单问题
说明：此类问题涉及模型在业务门户中的展示和访问，与“数据授权”中的菜单权限配置密切相关。
问题现象：
- 业务门户中看不到已授权的模型菜单。
- 点击菜单后页面404或无法加载。
- 菜单名称显示乱码或未国际化。
- 自定义扩展菜单无法显示或访问。
排查步骤：
第一步：排除产品BUG。
- 操作：
- 优先申请最新的EOS 8.3.3 AFCenter UI补丁，解决大部分前端展示类问题。
- 在MDM官方补丁列表中，搜索关键词
菜单、门户、404、扩展菜单。
- 相关补丁：
PLATFORM_8.3.3_AFCENTER_UI_20251219_P1（解决低开页面字段显示为空等问题）MDM_7.3_UI_20251215_P1（优化工作台跳转，解决404错误）MDM_7.3_UI_20260209_P1（解决工作台我的流程、问题数据跳转404）MDM_7.3_UI_20251106_P1（优化组织显示等问题）
- 解决方案：若找到描述匹配的补丁，则申请并应用。
- 操作：
第二步：根据问题现象排查。
现象：菜单不显示
- 排查项：在“数据授权”中，检查对应角色是否已配置该模型的“菜单权限”。
- 排查项：确认用户是否已分配到正确的平台角色（编码以
mdm-开头）。 - 排查项：模型的“排序号”是否设置，影响菜单显示顺序。
- 解决方案：
- 在“数据授权”中为角色配置模型的菜单权限。
- 确保用户角色分配正确。
- 为模型设置排序号。
现象：点击菜单404
- 排查项：检查Nginx转发配置是否正确，特别是静态资源路径。
- 排查项：检查AFCenter后端服务是否正常。
- 解决方案：
- 添加正确的Nginx转发配置：
location /api/afc { proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-EOS-SourceSysKey dc6baaed30e541d78bb91274803d9432; proxy_pass http://AFCenter后端IP:端口; } - 确保AFCenter服务正常运行。
- 添加正确的Nginx转发配置：
现象：菜单名称乱码/未国际化
- 排查项：模型的“模型名称”是否已正确设置。
- 排查项：国际化场景下，是否已提取中文翻译。
- 解决方案：
- 修改模型名称为正确显示的名称。
- 在“页面配置”中使用国际化资源配置，提取中文翻译。
- 如涉及需通过jar文件解决的国际化问题：请通过AME+发起工单，申请获取对应的国际化补丁jar包，放置到
mdm/lib目录下并重启服务。
现象：扩展菜单无法显示
- 排查项：自定义页面的“资源编码”是否正确复制并填写到扩展菜单配置中。
- 排查项：填写页面编码时是否去掉了“mdm”前缀。
- 解决方案：
- 在低开中心复制正确的资源编码。
- 在“数据授权”->“菜单功能权限”->“低开扩展”中，填写去掉前缀后的页面编码。