# 资产编目相关问题排查指南

# 排查指南详细说明

通用前置检查：

确认版本：明确是7.5.0版本。
确认模块集成：确认平台参数 DAM_BUILD_MODEL.IS_OPEN 为 Y。
查阅补丁列表：优先检索官方补丁。您可以通过以下链接访问官方补丁列表：
- DAMP 7.5.0 补丁列表: 数据资产7.5.0补丁列表 (opens new window)

# 场景一：模型创建/编辑失败

高频现象：
1. 新增概念模型、逻辑模型时无反应或报错。
2. 双击表无法进入字段维护页面。
3. 点击数据源展开无子项，无法逆向生成模型。
4. 物理模型点击报空指针。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 物理模型、空指针、创建。
  - 相关补丁示例：
    - DAMP_7.5.0_SERVER_20251229_P1（解决模型查询显示组织机构信息）
    - METACUBE_7.5.1_SERVER_20250724_P1（解决元数据采集后物理模型空指针）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：检查达梦数据库配置。
  - 现象：点击项目数据源展开无子项，无法逆向生成模型。
  - 排查项：dm_db_vendor 表中配置错误。
  - 解决方案：
```
-- 检查数据库供应商配置
SELECT * FROM dm_db_vendor WHERE name LIKE '%dameng%';

-- 如果name列值为'dameng8'，修改为'dm'
UPDATE dm_db_vendor SET name = 'dm' WHERE name = 'dameng8';

-- 同时检查dm_db_type表
UPDATE dm_db_type SET name = 'dm' WHERE name = 'dameng';

-- 修改后重启服务
```
3. 第三步：检查数据源配置。
  - 操作：确认系统已正确关联数据源。
  - 排查项：
    - 在“系统管理”中，该系统是否已关联数据源。
    - 关联的数据源是否已成功采集元数据。
    - 数据源连接测试是否通过。
  - 解决方案：
    - 如果未关联数据源，在系统管理中补充数据源。
    - 如果数据源连接失败，修正数据源配置后重试。
4. 第四步：处理“物理模型点击报空指针”问题。
  - 现象：点击物理模型菜单或查看元数据时报空指针。
  - 解决方案：
    1. 申请补丁 METACUBE_7.5.1_SERVER_20250724_P1。
    2. 打补丁后，在系统管理中删除已选择的数据源，重新选择。
    3. 重新采集元数据后，再次查看物理模型。

# 场景二：模型发布/流程异常

高频现象：
1. 逻辑模型发布不走流程，点击发布后直接发布。
2. 模型提交后无反应，不进入流程。
3. 发布检核卡住，无法完成。
4. 模型变更失败。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 发布、流程、检核。
  - 相关补丁示例：
    - DAMP_7.5.0_SERVER_20251208_P1（解决建模系统信息不同步）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：检查流程开关配置。
  - 现象：逻辑模型发布不走流程，点击发布后直接发布。
  - 操作：进入“技术门户” -> “配置中心” -> “平台参数”。
  - 排查项：DAM_BUILD_MODEL.isOpenFlow 参数是否设置为 Y（开启流程）。
  - 解决方案：如果设置为 N，修改为 Y 后点击“刷新缓存”。
3. 第三步：检查模型提交流程。
  - 现象：点击“模型提交”无反应。
  - 排查项：
    - 模型是否已完成开发（所有必填项已填）。
    - 流程定义是否已正确配置。
  - 解决方案：
    - 确保模型必填项已填写完整。
    - 在“流程中心”中确认模型发布流程存在。
4. 第四步：检查系统状态。
  - 现象：模型变更失败，提示“系统状态不可变更”。
  - 排查项：系统中是否有未完成的流程。
  - 解决方案：
    - 在“我的系统”列表中，检查该系统是否有进行中的流程。
    - 完成或终止所有未完成流程后，重新发起变更。

# 场景三：模型关联/关系异常

高频现象：
1. 逻辑实体关联物理表后，资产编目中不显示。
2. 引用物理实体时，字段不显示。
3. 物理模型添加关联的搜索框无法正常搜索。
4. 模型间关系配置后不生效。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 关联、引用、字段不显示。
  - 相关补丁示例：
    - DAMP_7.5.0_SERVER_20251223_P1（解决引用物理实体字段不显示）
    - DAMP_7.5.0_SERVER_20251224_P1（解决逻辑实体导入关联提示表不存在）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：处理“引用物理实体字段不显示”问题。
  - 现象：逻辑实体引用物理实体时，字段不显示。
  - 排查项：补丁冲突问题。
  - 解决方案：
    - 去掉bug号为 DAMPWH-379 的jar包。
    - 重启资产服务后重新关联。
3. 第三步：处理“物理模型添加关联搜索框无法搜索”问题。
  - 现象：物理模型添加关联时，搜索框无法正常搜索。
  - 排查项：补丁冲突问题。
  - 解决方案：
    - 去掉bug号为 DAMPWH-379 的jar包。
    - 重启资产服务后重新尝试搜索。
4. 第四步：检查关联配置。
  - 操作：确认逻辑模型已成功发布。
  - 操作：确认物理表已采集成功。
  - 操作：在模型管理中重新建立关联关系。

# 场景四：模型导入/导出异常

高频现象：
1. 逻辑模型导出数据，主题域的数据是空的。
2. 概念模型导入后，实体关系图中无关系显示。
3. 一站式编目导入失败，提示文件解析错误。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 导出、主题域、导入。
  - 相关补丁示例：
    - DAMP_7.5.0_SERVER_20251112_P2（解决逻辑模型导出主题域为空）
    - DAMP_7.5.0_UI_20251013_P1（解决概念模型导入关系不显示）
    - DAMP_7.5.0_SERVER_20251209_P1（解决一站式编目导入失败）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：检查文件配置。
  - 操作：确认使用官方提供的导入模板。
  - 操作：在“导入模型配置”中调整实体数量限制（建议≤200）。
  - 操作：检查nginx文件上传大小限制是否足够。
3. 第三步：检查主题域配置。
  - 现象：逻辑模型导出时，主题域数据为空。
  - 解决方案：申请补丁 DAMP_7.5.0_SERVER_20251112_P2。
4. 第四步：检查关系配置。
  - 现象：概念模型导入后，实体关系图中无关系显示。
  - 解决方案：申请补丁 DAMP_7.5.0_UI_20251013_P1。

# 场景五：资产编目/发布异常

高频现象：
1. 批量关联主题域后，新关联的主题域下查不到资产信息。
2. 逻辑模型发布不走流程。
3. 资产编目时主管部门无数据，报“id不能为空”。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 批量关联、主题域、主管部门。
  - 相关补丁示例：
    - DAMP_7.5.0_SERVER_20250909_P1（解决批量关联主题域查不到资产）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：检查主管部门配置。
  - 现象：资产编目时主管部门无数据，报“id不能为空”。
  - 操作：进入“编目” -> “目录管理” -> “部门目录”。
  - 排查项：部门目录是否已同步。
  - 解决方案：点击“重新同步”按钮，同步部门信息。
3. 第三步：检查主题域配置。
  - 现象：批量关联主题域后查不到资产。
  - 排查项：主题域是否为叶子节点。
  - 解决方案：确认关联的主题域是L2叶子节点。
4. 第四步：检查必填项。
  - 操作：确认资产编目表单中的必填项已填写。
  - 排查项：
    - 资产名称、资产编码
    - 所属应用系统
    - 主管部门（自动带出）
    - 主题域（至少选择一个）

# 场景六：资产检索/显示异常

高频现象：
1. 资产详情页中，相关标准列最多展示2个，超过2个的标准不展示。
2. 资产检索不到最新发布的资产。
3. 资产卡片显示不全或格式错乱。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 资产详情、标准列、显示。
  - 相关补丁示例：
    - DAMP_7.5.0_UI_20251121_P1（解决资产详情标准列显示不全）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：检查ES索引状态。
  - 操作：进入“技术门户” -> “配置中心” -> “系统工具”。
  - 排查项：资产ES索引是否正常。
  - 解决方案：点击“资产ES初始化”，重建索引。
3. 第三步：检查分词配置。
  - 操作：进入“技术门户” -> “配置中心” -> “平台参数”。
  - 排查项：catalog.isParticiple 分词配置是否合理。
  - 解决方案：根据检索需求调整分词配置。
4. 第四步：检查资产发布状态。
  - 操作：确认资产状态为“已发布”。
  - 解决方案：完成发布流程。

# 场景七：主题目录/分类异常

高频现象：
1. 主题目录无法删除，提示还有关联。
2. 一站式编目中选择主题域无法选择。
3. 主题目录下查不到资产。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 主题目录、删除、关联。
  - 相关补丁示例：
    - DAMP_7.5.0_SERVER_20251020_P1（解决主题域无法删除）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：检查主题类型。
  - 现象：一站式编目中选择主题域无法选择。
  - 排查项：主题域类型是否为L2，是否为叶子节点。
  - 解决方案：确认选择的主题域满足条件：
    - 主题类型为L2-主题域
    - 必须为叶子节点
3. 第三步：检查关联关系。
  - 现象：主题目录无法删除，提示还有关联。
  - 排查项：该主题下是否仍有资产、模型关联。
  - 解决方案：
    - 解除所有关联关系（资产、概念模型、逻辑模型、服务等）。
    - 确认无关联后重新尝试删除。

← 数据资产系统管理相关问题排查指南数据资产管理平台V7.5 →