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

# 数据资产与元数据集成相关问题

# 一、数据资产元数据管理不能正常跳转，报“登录信息已过期，请重新登陆”

# （一）问题表象

在数据资产门户中，使用admin账号（或其他有权限账号）成功登录后，点击「元数据管理」菜单，无法正常跳转至元数据管理页面，页面反复弹出提示“登录信息已过期，请重新登陆”

# （二）分步排查方案

# 第一步：排查浏览器缓存及登录状态有效性（基础排查，排除前端缓存异常）

# 目的

确认异常并非浏览器缓存堆积、登录Cookie失效或会话冲突导致，排除前端简单异常，缩小排查范围。

# 操作

  1. 关闭当前所有浏览器窗口（含资产门户、元数据管理相关页面），清空浏览器全部缓存（含Cookie、历史记录、缓存文件），建议使用“清除所有时间范围”的缓存清理选项；

  2. 重启浏览器，仅打开一个窗口，访问数据资产门户，使用admin账号正常登录，登录后立即点击「元数据管理」菜单，观察是否跳转及提示；

  3. 更换2种不同内核的浏览器（如Chrome、Edge），重复步骤1-2，排除浏览器内核兼容问题。

# 结论

  • 若清除缓存、更换浏览器后，点击「元数据管理」可正常跳转，无登录过期提示，则说明异常为前端浏览器缓存堆积、Cookie会话冲突导致，排查结束，后续建议定期清理浏览器缓存，或使用无痕模式操作；

  • 若清除缓存、更换浏览器后，仍反复报登录过期，说明异常并非前端缓存问题，需进入下一步排查（后端配置或会话同步异常）。

# 第二步：排查dgs服务、互通账号及会话同步配置（核心排查，定位产品设计相关异常）

# 目的

排查dgs服务运行状态、资产平台与元数据平台互通账号配置，以及双方会话同步配置的合理性，确认是否满足产品设计层面的免登录跳转要求，定位核心异常点。该步骤为解决登录过期跳转异常的关键，直接决定资产门户与元数据管理模块的会话互通有效性。

# 操作

# 2.1 核心前置：检查资产平台与元数据平台互通账号

注意：访问元数据平台创建/验证互通账号前，需先修改afc.enable=false（后续会回改为true），否则无法通过无痕浏览器正常访问元数据平台登录页面，影响账号检查操作。

互通账号为免登录跳转的基础前提，需优先确认双方账号一致性，具体操作如下：

  • 登录数据资产平台，记录当前用于登录的账号（如admin），确认该账号状态正常、无禁用/锁定情况；

  • 使用无痕浏览器访问元数据平台登录页面，尝试使用该账号（与资产平台一致）登录，观察是否能成功登录；

  • 若无法登录（提示账号不存在），需先使用元数据平台管理员账号sysadmin登录（默认密码为primeton@123），登录后在元数据平台创建与资产平台登录账号完全一致的账号，账号名称需严格匹配（区分大小写），密码可按需设置（无需与资产平台密码一致）；

  • 确认新建账号已授予“平台管理员”权限，确保其拥有元数据管理模块的全部操作权限，权限配置完成后，退出元数据平台登录，重新验证账号登录有效性。

# 2.2 关键同步：检查redis连接一致性

资产平台与元数据平台需连接同一redis，否则会话无法同步，导致跳转异常，具体操作如下：

  • 登录数据资产平台后端服务器，定位redis配置文件（默认路径可参考：/etc/redis/redis.conf，或结合实际部署路径调整），查看redis连接地址、端口、密码（若有），记录核心配置参数；

  • 登录元数据平台后端服务器，找到对应redis配置文件，查看其连接地址、端口、密码，与资产平台redis配置参数逐一比对；

  • 确认双方redis配置完全一致（地址、端口、密码均无差异），且redis服务处于正常运行状态（可通过redis-cli ping命令验证连接有效性）；

  • 若双方redis配置不一致，修改元数据平台redis配置，使其与资产平台保持一致，保存配置文件后，重启元数据平台相关服务及redis服务，确保配置生效。

# 2.3 最终保障：检查afc配置有效性

重点确认afc.enable已回改为true，且前端登录地址配置正确，确保会话同步生效，具体操作如下：

  • 登录数据资产平台后端服务器，定位元数据管理相关配置文件：dgs/server/conf/application.yml（若部署环境存在自定义目录，可结合实际部署路径调整）；

  • 打开该配置文件，找到afc配置节点，重点检查两项核心配置：

afc:
  app_code: EOS-DEMO-SYS  # 默认配置，无需修改，保持原有参数不变
  enable: true           # 关键配置，需确认已回改为true，确保会话同步生效
  login_url: http://192.168.2.xx:80  # 需确认与实际数据资产平台前端访问地址完全一致，不可有误

  • 若afc.enable未设为true，立即修改为true；若login_url与前端实际访问地址不一致，替换为正确的前端登录地址，确保地址无端口错误、IP错误；

  • 配置修改完成后，保存配置文件，重启dgs服务（如systemctl restart dgs），等待服务重启成功（可通过服务状态命令或核心日志验证）。

# 2.4 验证生效：检查配置及跳转有效性

清除浏览器全部缓存（含Cookie），登录数据资产平台（使用已验证有效的互通账号），点击「元数据管理」菜单，观察是否可正常跳转至元数据管理页面，且无“登录信息已过期”提示。

# 结论

  • 若互通账号配置正确（可正常登录）、双方redis连接一致、afc.enable设为true且login_url配置正确，重启dgs服务后跳转正常无登录过期提示，则说明异常为未满足会话同步前提条件（账号/redis/afc配置异常），排查结束；

  • 若上述所有操作均已完成（账号一致可登录、redis配置一致、afc配置正确且重启服务），但仍弹出“登录信息已过期”提示，建议备份相关配置和日志，联系研发团队排查底层代码异常（如会话校验逻辑错误、跨模块登录校验不兼容）。

# 二、公共资源添加数据源挂载系统后，物理模型菜单无物理模型信息

# （一）问题表象

在数据资产门户公共资源模块中，成功添加数据源并将其挂载到对应系统后，进入系统下的「物理模型」菜单，页面无任何物理模型信息展示。

# （二）分步排查方案

# 第一步：排查元数据或executor服务运行状态

# 目的

确认元数据dgs核心服务、executor执行器处于正常运行状态，排除因服务未启动、异常停止导致的物理模型无法加载，为数据源同步、采集提供基础保障。

# 操作

登录元数据平台后端服务器，通过ps命令查询dgs、executor进程状态，判断进程是否存在、是否假死，结合服务状态检查完成排查并重启异常进程，具体操作如下：

  1. 查询进程是否存在：执行命令 ps -ef | grep dgs 排查dgs进程，执行 ps -ef | grep executor 排查executor进程，若查询结果无对应进程信息，说明进程未启动；

  2. 判断进程是否假死：操作是否有日志输出；

  3. 进程重启操作：进程未启动或假死时，重启dgs服务何执行器。

  4. 后续操作：上述进程重启操作完成后，需进入数据资产平台，找到对应系统，将该系统下已挂载的数据源删除，删除后重新从公共资源中选择该数据源进行挂载，确保数据源与系统关联正常，挂载完成后再次进入「物理模型」菜单，观察信息是否正常显示。

# 结论

  • 若重启服务、重新挂载后，物理模型菜单正常显示信息，则说明异常为元数据或executor服务未正常运行导致，排查结束，后续建议定期检查相关服务运行状态，避免服务异常停止；

  • 若重启服务、重新挂载后，物理模型仍无信息，说明异常并非服务运行问题，需进入下一步排查。

# 第二步：排查补丁安装情况

# 目的

确认系统已安装对应功能补丁，排除因缺少补丁导致“查看元数据”按钮缺失、元数据无法正常关联展示，进而物理模型无信息的异常。

# 操作

将数据源挂载到系统后，首先进入数据资产平台编辑该资产系统，查看数据源操作栏中是否有“查看元数据”按钮；若无该按钮，说明系统缺少对应功能补丁，需申请并安装补丁：METACUBE_7.5.1_SERVER_20250724_P1，补丁安装完成后，重启数据资产平台核心服务，再次将数据源挂载到系统，确认操作栏中“查看元数据”按钮正常显示，再进入下一步排查。

# 结论

  • 若安装补丁、重启服务并重新挂载后，“查看元数据”按钮正常显示，且后续物理模型可正常加载，则说明异常为缺少对应功能补丁导致，排查结束；

  • 若“查看元数据”按钮正常显示（或已安装补丁），物理模型仍无信息，需进入下一步排查。

# 第三步：排查数据源同步与采集状态

# 目的

确认数据源挂载时已完成同步、同步后已执行采集操作，排除因同步缺失、采集未执行或executor未配置导致的物理模型无信息，明确采集环节是否正常。

# 操作

重点排查两项核心内容，确保同步与采集环节正常，具体操作如下：

  1. 检查数据源同步状态：进入元数据管理模块，精准查找对应数据源，确认该数据源已同步至元数据管理模块（排除资产平台与元数据平台同步断层）；若未同步，重新将数据源从公共资源挂载至系统，挂载后再次进入元数据管理模块，核实数据源是否同步成功。
  2. 检查采集任务及采集日志：若数据源已同步（资产平台、元数据管理中均可见），但物理模型仍无信息，首先确认是否已为该数据源生成采集任务，查看采集任务列表，核实任务是否创建、是否处于待执行/已执行状态；若未生成采集任务，需先进入元数据平台，查看平台内是否存在executor执行器，同时检查执行器是否正常运行；若执行器不存在或运行异常，需先在元数据平台配置并启动executor执行器，再发起采集任务；若已生成采集任务，查看采集日志，通过日志确认采集任务是否实际执行、有无执行记录。

# 结论

  • 若完成同步、采集（或配置executor后完成操作），物理模型菜单正常显示，则说明异常为数据源未同步、未采集或缺少executor导致，排查结束；

  • 若同步、采集均正常（executor已配置），物理模型仍无信息，需进入下一步排查。

# 第四步：排查采集报错及数据源信息准确性

# 目的

排查采集任务是否存在报错，确认数据源配置信息（数据库地址、端口、schema等）准确无误，排除因配置错误导致的采集失败、物理模型无法加载。

# 操作

若数据源已完成同步、采集操作，但物理模型菜单仍无信息，登录元数据平台后端服务器，查看采集日志，重点排查日志中是否存在“库连接失败”“schema不匹配”“数据库地址错误”等相关报错；若存在此类报错，返回数据资产门户公共资源模块，编辑已挂载的数据源，修正数据库地址、端口、schema等错误信息，保存修改后，重新执行采集任务，完成后检查物理模型菜单是否正常显示。

# 结论

  • 若修正数据源信息、重新同步采集后，物理模型正常显示，则说明异常为数据源信息错误导致采集失败，排查结束，后续建议添加数据源时仔细核对配置信息；

  • 若数据源信息无误、采集无报错，物理模型仍无信息，建议备份相关日志（采集日志、服务日志），联系研发团队排查底层关联异常。

# 三、数据资产编目点击物理模型页面接口报错404 not find

# （一）问题表象

在数据资产编目模块中，点击「物理模型」页面，页面加载失败，接口报错提示“404 not find”，无法正常展示物理模型相关内容。

# （二）分步排查方案

# 第一步：检查元数据及资产平台前端配置文件（基础排查）

# 目的

确认元数据前端配置文件、资产平台前端配置文件配置正确，排除因配置缺失、参数错误导致的接口404报错，为后续排查奠定基础。

# 操作

  1. 检查元数据前端配置文件：定位路径web/conf/metacube.conf，确认配置内容如下（重点核对监听端口、代理地址）：
server {
    listen 83;  # 元数据前端访问端口
    proxy_buffer_size 128k;
    proxy_buffers 32 128k;
    proxy_busy_buffers_size 128k;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Real-Port $remote_port;
    proxy_set_header REMOTE-HOST $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

    location / {
        root /opt/dampstandalone/web/metacube;
        index index.html index.htm;
        try_files $uri /index.html;
    }
    location /dgs {
        charset utf-8;
        proxy_pass http://127.0.0.1:28079;  # 代理至dgs后端访问端口（28079为dgs后端端口）
    }
}
  1. 检查资产平台前端配置文件：定位路径web/conf/damp.conf，确认包含以下配置（重点核对代理路径及目标地址）：
location /fd_dgs/ {
    proxy_pass http://127.0.0.1:83/ ;  # 代理至元数据前端端口（83）
  }

  location ^~ /dgs {
    charset utf-8;
    proxy_pass http://127.0.0.1:28079;  # 代理至dgs后端端口（28079）
  }
  1. 若任一配置文件缺失、参数错误（如端口、代理地址不符），修正后保存配置，重启前端服务确保配置生效。

# 结论

  • 若修正配置文件、重启服务后，接口无404报错、页面正常加载，则说明异常为配置文件错误导致，排查结束；

  • 若配置文件无误、重启服务后仍报错404，需进入下一步排查。

# 第二步：排查元数据配置地址有效性（核心排查）

# 目的

确认配置中心中元数据相关地址配置正确，排除因地址错误导致无法联通元数据平台、接口调用失败（404报错）的异常。

# 操作

  1. 进入数据资产平台配置中心，找到「平台参数」模块，定位「元数据配置」栏目；

  2. 查看该栏目下的metacube.serverUrl配置项，核实配置的地址是否正确，正确配置格式为：http://192.168.2. xx :28079/dgs

  3. 若地址配置错误，修改为正确的元数据平台地址，保存配置并生效。

# 结论

  • 若调整metacube.serverUrl地址后，重新点击「物理模型」页面，接口无404报错、页面正常加载，则说明异常为地址配置错误导致，排查结束；

  • 若地址配置正确，仍报错404，建议检查元数据平台接口是否正常，或联系研发团队排查接口路由异常。

# 四、数据资产系统落标统计页面部分系统显示空白

# （一）问题表象

进入数据资产门户「系统落标统计」页面，查看各系统落标统计数据时，部分系统对应的页面显示空白，无任何统计信息、无报错提示，其余系统统计页面显示正常。

# （二）分步排查方案

# 第一步：排查是否未执行过系统落标统计

# 目的

确认空白页面对应的系统，是否已发起并执行系统落标统计任务，排除因未执行统计导致无数据展示、页面空白的基础异常。

# 操作

  1. 进入数据资产「系统落标统计」相关操作模块，找到页面空白对应的系统；

  2. 若未执行过系统落标统计，发起该系统的落标统计任务，等待任务执行完成后，刷新页面查看是否正常显示统计数据。

# 结论

  • 若执行落标统计任务后，页面空白消失、正常显示统计数据，则说明异常为未执行统计任务导致，排查结束；

  • 若已执行统计任务，页面仍显示空白，需进入下一步排查。

# 第二步：参考问题二排查，确认该系统是否未被采集到元数据（

# 目的

排查页面空白是否因该系统未被采集到元数据导致（核心说明：资产系统中，物理模型等同于元数据，物理模型未采集即元数据未采集），排除元数据未采集引发的统计数据无法展示问题，参考问题二（公共资源添加数据源挂载系统后，物理模型菜单无物理模型信息）的排查逻辑开展操作。

# 操作

参考问题一（数据资产元数据管理不能正常跳转）的排查逻辑，重点排查空白页面对应系统下元数据加载异常问题，具体参考如下：

  1. 基础排查：清除浏览器缓存、更换不同内核浏览器，刷新「系统落标统计」页面，排查前端缓存导致的元数据加载异常；

  2. 核心排查：参考问题二（物理模型无信息）的排查逻辑，重点检查该系统关联的数据源同步状态、元数据采集情况，确认系统已被采集到元数据（即物理模型已正常采集），具体包括：检查数据源是否同步至元数据管理、采集任务是否生成并执行、executor执行器是否正常、采集日志是否无报错；

  3. 验证元数据采集：进入该系统对应的「物理模型」菜单，核实系统下物理模型（元数据）是否可正常加载、无缺失，确认元数据已成功采集；

# 结论

  • 若排查并修复元数据加载异常后，系统落标统计页面空白消失、正常显示数据，则说明异常为系统下无法加载元数据导致，排查结束；

  • 若元数据可正常加载，页面仍空白，建议备份相关日志，联系研发团队排查落标统计数据生成及渲染异常。

上次更新: 2026/2/10下午2:15:21

← 数据资产管理平台V7.5 →