普元数据资产管理平台
运维指南

# 系统管理相关问题排查指南

# 排查指南详细说明

通用前置检查：

  • 确认版本：明确是7.5.0版本。
  • 确认用户权限：系统管理功能需要“资产管理员”或“租户管理员”权限。
  • 查阅补丁列表：优先检索官方补丁。您可以通过以下链接访问官方补丁列表：

# 场景一：系统创建/编辑失败

  • 高频现象：

    1. 新增系统时，点击“提交”无反应或报错。
    2. 编辑系统后保存失败。
    3. 系统编码提示已存在。
    4. 保存时报“操作数据异常”。

  • 排查步骤：

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

      • 操作：在官方补丁列表中，搜索关键词 系统管理、新增、编辑。
      • 解决方案：
        • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
        • 2.若找到描述匹配的补丁，则申请并应用

    2. 第二步：检查必填项。

      • 操作：核对系统创建表单中的必填字段。
      • 排查项：
        • 系统编码、系统名称是否已填写。
        • 所属部门是否已选择。
        • 项目经理是否已选择。
        • 系统状态是否已选择。
      • 解决方案：补充完整必填项后重新提交。

    3. 第三步：检查编码唯一性。

      • 操作：确认系统编码在平台内唯一。
      • 排查项：提示“系统编码已存在”或类似错误。
      • 解决方案：修改系统编码，使用未被占用的编码。

    4. 第四步：检查部门/项目经理配置。

      • 操作：确认所选部门和项目经理存在且有效。
      • 排查项：
        • 部门是否已在“部门目录”中同步。
        • 项目经理是否在平台中有账号。
      • 解决方案：
        • 在“部门目录”中点击“重新同步”同步部门信息。
        • 确认项目经理账号存在且状态正常。

# 场景二：系统导入/导出异常

  • 高频现象：

    1. 导出系统时报语法错误。
    2. 导出的Excel内容为空。
    3. 系统导入失败，提示模板错误。
    4. 导入后数据不正确或丢失。

  • 排查步骤：

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

      • 操作：在官方补丁列表中，搜索关键词 导出、导入、语法错误。
      • 解决方案：
        • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
        • 2.若找到描述匹配的补丁，则申请并应用

    2. 第二步：检查模板格式。

      • 操作：确认使用的是从当前系统下载的最新模板。
      • 排查项：
        • 模板文件是否损坏。
        • 必填列是否填写完整。
        • 系统编码是否唯一。
        • 部门名称是否与系统内一致。
      • 解决方案：重新下载模板，将数据以纯文本格式粘贴后重新上传。

    3. 第三步：检查数据库驱动（达梦数据库特有）。

      • 现象：导出系统时报语法错误，如 Cause: java.sql.SQLException: 发生语法错误。
      • 排查项：达梦数据库驱动问题。
      • 解决方案：
        • 更换达梦数据库驱动为正确版本。
        • 在JDBC URL中添加 ?columnNameUpperCase=false。

    4. 第四步：检查导出权限。

      • 操作：确认当前用户有导出系统的权限。
      • 排查项：用户是否拥有“资产管理员”角色。
      • 解决方案：使用admin账号授予相应权限。

# 场景三：系统与数据源关联问题

  • 高频现象：

    1. 系统中选择数据源时，列表为空。
    2. 关联数据源后，元数据采集不到。
    3. 数据源测试连接失败。
    4. 系统与数据源关联后，模型管理中看不到表。

  • 排查步骤：

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

      • 操作：在官方补丁列表中，搜索关键词 数据源、关联、同步。
      • 相关补丁示例：
        • DAMP_7.5.0_SERVER_20251208_P1（解决建模系统信息不同步）
      • 解决方案：
        • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
        • 2.若找到描述匹配的补丁，则申请并应用

    2. 第二步：检查数据源状态。

      • 操作：进入“公共资源” -> “数据源管理”。
      • 排查项：
        • 数据源是否存在。
        • 数据源连接测试是否通过。
        • 数据源是否已被其他系统关联。
      • 解决方案：
        • 如果数据源不存在，先创建数据源。
        • 如果连接失败，修正数据源配置。
        • 如果已被关联，可以选择其他数据源或解除原关联。

    3. 第三步：检查数据源分配。

      • 操作：在系统编辑页面，检查“数据存储情况”中是否已关联数据源。
      • 排查项：是否已通过“选择数据源”按钮选择了数据源。
      • 解决方案：点击“选择数据源”，选择需要关联的数据源后保存。

    4. 第四步：检查元数据采集。

      • 操作：确认元数据已成功采集。
      • 排查项：在“元数据管理”中是否能查看到该数据源的表。
      • 解决方案：如果元数据未采集，执行采集任务。

    5. 第五步：处理“选择数据源列表为空”问题（7.5版本特性）。

      • 说明：7.5.0版本中，系统中不再能够直接添加数据源信息。所有的数据源信息需要在“数据源管理”中统一维护，系统只能选择未被其他系统关联的数据源。
      • 解决方案：
        • 进入“公共资源” -> “数据源管理”，确认数据源已创建。
        • 确认数据源未被其他系统关联。
        • 刷新页面后重新选择。

# 场景四：系统权限/角色问题

  • 高频现象：

    1. 用户无法看到系统列表。
    2. 用户无法编辑系统信息。
    3. 项目经理无法管理系统下的资产。
    4. 部门管理员看不到本部门系统。

  • 排查步骤：

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

      • 操作：在官方补丁列表中，搜索关键词 权限、角色、可见。
      • 解决方案：
        • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
        • 2.若找到描述匹配的补丁，则申请并应用

    2. 第二步：检查角色授权。

      • 操作：使用admin账号登录，进入“应用中心” -> “权限管理” -> “角色管理”。

      • 各角色权限说明：

        角色 系统权限 说明
        资产管理员 查看所有系统、编辑所有系统 平台超级管理员
        资产部门管理员 查看本部门系统、编辑本部门系统 部门级管理
        项目经理 查看自己负责的系统、编辑自己负责的系统 系统级管理
        资产普通用户 查看系统（只读） 普通用户

      • 解决方案：

        • 为用户授予相应的角色。
        • 确保角色已授权“查询应用列表功能”。

    3. 第三步：检查部门管理员配置。

      • 现象：部门管理员看不到本部门系统。
      • 排查项：系统“所属部门”是否正确，用户是否为该部门的部门管理员。
      • 解决方案：
        • 在系统编辑页面，确认“所属部门”选择正确。
        • 确认用户在该部门下有“资产部门管理员”角色。

    4. 第四步：检查项目经理配置。

      • 现象：项目经理无法管理系统下的资产。
      • 排查项：系统“项目经理”字段是否选择了该用户。
      • 解决方案：在系统编辑页面，将“项目经理”修改为正确的用户。

# 场景五：系统显示/加载异常

  • 高频现象：

    1. 系统列表加载缓慢或卡死。
    2. 系统详情页面空白或报错。
    3. 系统图标显示异常。
    4. 分页加载失败。

  • 排查步骤：

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

      • 操作：在官方补丁列表中，搜索关键词 显示、加载、空白。
      • 解决方案：
        • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
        • 2.若找到描述匹配的补丁，则申请并应用

    2. 第二步：检查浏览器兼容性。

      • 操作：确认浏览器版本符合要求。
      • 要求：
        • Chrome ≥ 80
        • Edge ≥ 80
        • FireFox ≥ 74
      • 解决方案：
        • 升级浏览器到最新版本。
        • 清理浏览器缓存和Cookie。
        • 切换Chrome内核浏览器。

    3. 第三步：检查服务状态。

      • 操作：确认DAMP后端服务是否正常。
      • 命令：ps -ef | grep damp
      • 解决方案：如果服务异常，重启DAMP服务。

    4. 第四步：检查网络请求。

      • 操作：打开浏览器开发者工具（F12），查看Network标签。
      • 排查项：系统列表接口是否返回数据，是否有报错。
      • 解决方案：根据接口报错信息排查对应问题。

# 场景六：系统同步/集成问题

  • 高频现象：

    1. 系统信息与建模模块不同步。
    2. 删除系统后，建模模块仍显示。
    3. 系统修改后，其他模块未更新。
    4. 公共资源数据源同步失败。

  • 排查步骤：

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

      • 操作：在官方补丁列表中，搜索关键词 同步、建模、不一致。
      • 相关补丁示例：
        • DAMP_7.5.0_SERVER_20251208_P1（解决建模系统信息不同步）
      • 解决方案：
        • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
        • 2.若找到描述匹配的补丁，则申请并应用

    2. 第二步：检查公共资源集成配置。

      • 操作：进入“技术门户” -> “配置中心” -> “平台参数”。
      • 排查项：DAM_PUBLIC_RESOURCE.IS_OPEN 是否设置为 Y。
      • 解决方案：如果为 N，修改为 Y 后重启服务。

    3. 第三步：检查同步配置。

      • 操作：在系统修改后，确认是否触发了同步机制。
      • 排查项：建模模块中的系统信息是否及时更新。
      • 解决方案：
        • 申请补丁 DAMP_7.5.0_SERVER_20251208_P1。
        • 手动在建模模块中刷新或重启服务。

    4. 第四步：检查数据一致性。

      • 操作：直接查询数据库，对比系统表和建模模块系统表。

      • 排查项：数据是否一致，是否有脏数据。

      • 解决方案：

        -- 查询系统表
SELECT * FROM afc_system WHERE code = '系统编码';

-- 查询建模模块系统表
SELECT * FROM dm_system WHERE code = '系统编码';

-- 如果数据不一致，手动更新或删除脏数据
上次更新: 2026/3/19下午1:30:01

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