# 数据建模（IDE）相关问题排查指南

# 排查指南详细说明

通用前置检查：

确认版本：明确是7.5.0版本。
确认浏览器版本：数据建模IDE对浏览器有较高要求，需使用Chrome 80+、Edge 80+或FireFox 74+。
查阅补丁列表：优先检索官方补丁。您可以通过以下链接访问官方补丁列表：
- DAMP 7.5.0 补丁列表: 数据资产7.5.0补丁列表 (opens new window)

高频现象：
1. 点击“模型开发”进入IDE后，页面加载缓慢或卡死。
2. IDE页面空白或报错。
3. 模型画布无法正常显示。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 IDE、加载、卡死。
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：检查浏览器兼容性。
  - 操作：确认浏览器版本符合要求。
  - 要求：
    - Chrome ≥ 80
    - Edge ≥ 80
    - FireFox ≥ 74
  - 解决方案：
    - 升级浏览器到最新版本。
    - 清理浏览器缓存和Cookie。
    - 切换Chrome内核浏览器。
3. 第三步：检查模型实体数量。
  - 操作：确认当前模型中实体数量。
  - 排查项：单个模型文件实体总数超过200个时，可能影响IDE加载速度。
  - 解决方案：
    - 在“导入模型配置”中调整单次导入的最大实体数量。
    - 拆分大模型为多个小模型。
    - 分批进行模型开发。
4. 第四步：检查网络请求。
  - 操作：打开浏览器开发者工具（F12），查看Network标签。
  - 排查项：是否有接口请求失败或超时。
  - 解决方案：根据失败接口排查对应后端服务状态。

高频现象：
1. 物理模型列无法拖动。
2. 逻辑模型列无法拖动，看不到列表内容。
3. 实体拖拽后位置无法保存。
4. 双击实体无法进入字段维护页面。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 拖动、列、无法拖动。
  - 相关补丁示例：
    - DAMP_7.5.0_UI_20251231_P1（解决物理模型列无法拖动、逻辑模型列无法拖动看不到列表内容）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：检查浏览器版本。
  - 操作：确认浏览器版本符合要求。
  - 解决方案：升级浏览器到最新版本。
3. 第三步：调整分辨率/缩放。
  - 操作：如果字段列表显示不全，尝试调整浏览器分辨率或缩放比例。
  - 解决方案：
    - 将浏览器缩放比例调整为100%。
    - 调整屏幕分辨率。
    - 手动拖动列宽。
4. 第四步：清理浏览器缓存。
  - 操作：清理浏览器缓存后重新登录。
  - 解决方案：缓存问题可能导致IDE交互异常。

高频现象：
1. 实体间关系在IDE中配置后不生效。
2. 拖拽连线配置关系后，保存再打开关系丢失。
3. 关系配置界面无法正常弹出。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 关系、连线、拖拽。
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：检查关系配置方式。
  - 操作：确认拖拽方式是否正确。
  - 正确方式：
    - 将指针放在对应实体字段上。
    - 当指针变成十字时，拖拽至另一个实体的字段。
    - 弹窗配置关系类型（1:1/1:n/n:1）。
  - 解决方案：按照正确方式重新配置关系。
3. 第三步：检查浏览器兼容性。
  - 操作：使用Chrome 80+浏览器，清理缓存后重新配置。
4. 第四步：检查字段属性完整性。
  - 操作：确认参与关系的字段都有合法的数据类型和长度。
  - 解决方案：补全字段信息后重新建立关系。

高频现象：
1. 右侧【数据源】、【数据元标准】、【数据资产】中的资源无法拖拽到画布。
2. 点击数据源节点，无法展开看到表。
3. 拖拽资源到画布后，实体信息不显示。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 数据源、拖拽、展开。
  - 解决方案：
    - 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. 第三步：检查数据源状态。
  - 操作：确认数据源在“系统管理”中已正确配置且连接正常。
  - 解决方案：修正数据源配置后重新进入IDE。
4. 第四步：检查数据元标准/数据资产状态。
  - 操作：确认数据元标准已发布，数据资产状态为“已发布”。
  - 解决方案：完成发布流程后重新拖拽。

高频现象：
1. 创建完成模型后，点击“模型检核”无反应。
2. 检核结果异常或报错。
3. 检核日志无内容。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 检核、模型检核。
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：检查检核规则配置。
  - 操作：进入“配置管理” -> “检核规则配置”，检查规则状态。
  - 排查项：
    - 内置规则是否被错误关闭。
    - 自定义规则配置是否正确。
  - 解决方案：
    - 开启需要的内置规则。
    - 调整自定义规则参数。
3. 第三步：查看检核日志。
  - 操作：在IDE下方点击“模型检核”，点击“查看日志”。
  - 排查项：日志中的具体错误信息。
  - 解决方案：根据错误信息修复问题。
4. 第四步：重新运行检核。
  - 操作：点击“运行”按钮重新执行检核。
  - 解决方案：运行完成后查看检核结果。