# 数据资产流程相关问题排查指南（7.5版本）（修正版）

# 排查指南详细说明

通用前置检查：

确认版本：明确是7.5.0版本。
确认流程类型：资产发布流程、变更流程、申请流程、问题上报流程，不同流程的排查重点不同。
查阅补丁列表：优先检索官方补丁。您可以通过以下链接访问官方补丁列表：
- DAMP 7.5.0 补丁列表: 数据资产7.5.0补丁列表 (opens new window)

# 场景一：流程发起失败

高频现象：
1. 点击“提交”后报错，无法发起流程。
2. 报主键冲突错误：Duplicate entry '...' for key 'PRIMARY'。
3. 报事务回滚错误。
4. 流程发起后无反应。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 流程、提交、主键冲突。
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：处理主键冲突问题。
  - 现象：报错 Duplicate entry '...' for key 'PRIMARY'。
  - 排查项：
    - 网络波动时用户重复点击提交按钮。
    - BPS流程定义ID生成器达到上限。
    - 流程相关表存在脏数据。
  - 解决方案：
    
    方案A：清理重复数据
    - 找到重复的主键值对应的流程，根据情况删除或忽略。
    - 如果是重复点击导致，忽略即可，重新发起新流程。
    方案B：调整BPS唯一ID生成器
```
-- 检查eos_unique_table表
SELECT * FROM eos_unique_table WHERE NAME = 'ProcessDefPropertiesID';

-- 修改CODE值为更大的数（如原值+20）
UPDATE eos_unique_table 
SET CODE = CODE + 20 
WHERE NAME = 'ProcessDefPropertiesID';

-- 重启BPS服务
```
3. 第三步：处理事务回滚问题。
  - 现象：报错 Transaction rolled back because it has been marked as rollback-only。
  - 排查项：业务表字段长度不足，如rcm_operation_log表的BUS_ID字段。
  - 解决方案：
```
-- 修改表结构，增加BUS_ID字段长度
ALTER TABLE rcm_operation_log MODIFY BUS_ID VARCHAR(1000);
-- 或改为TEXT类型
ALTER TABLE rcm_operation_log MODIFY BUS_ID TEXT;

-- 修改后重启服务，重新发起流程
```
4. 第四步：检查用户权限。
  - 现象：点击提交无反应或提示无权限。
  - 排查项：用户是否拥有发起流程的权限。
  - 解决方案：
    - 资产发布/变更：需要资产管理员或部门管理员角色。
    - 资产申请：普通用户即可发起。
    - 问题上报：普通用户即可发起。

# 场景二：流程卡住/无法审批

高频现象：
1. 流程提交后长时间处于“审核中”。
2. 流程回退后卡住，无法继续或终止。
3. 资源准备环节卡住，无法完成。
4. 点击审批按钮无响应。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 卡住、审核中、回退。
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：处理审核中卡住问题。
  - 操作：检查流程实例当前状态。
  - SQL查询：
```
-- 查询BPS流程实例表
SELECT * FROM bps_process_instance WHERE business_key = '资产ID';

-- 查询待办任务表
SELECT * FROM bps_work_item WHERE process_instance_id = '实例ID';
```
  - 排查项：
    - 是否有节点处于待处理状态但无人处理。
    - 是否有节点执行失败但未报错。
  - 解决方案：
    - 在“流程中心”中手动推进或终止流程。
    - 清理bfp_process_opinions表中的脏数据：
      CREATE TABLE bfp_process_opinions_bak_yyyymmdd AS SELECT * FROM bfp_process_opinions; DELETE FROM bfp_process_opinions WHERE process_id = '问题流程ID';
3. 第三步：处理回退后卡住问题。
  - 现象：资产变更流程回退并终止后，资产状态卡在“变更中”。
  - 排查项：流程配置中发起人环节的终止操作设置。
  - 解决方案：
    1. 管理员登录，进入“工作流程” -> “业务配置” -> “流程配置”。
    2. 找到对应的资产流程（如资产变更流程）。
    3. 点击流程定义，进入“环节定义”页签。
    4. 找到“发起人”环节，点击“修改”。
    5. 将“终止操作”从默认值改为 “保存数据”。
    6. 保存配置后重新发起流程测试。
    原理：当流程在发起人环节被终止时，“保存数据”选项会保存当前变更的数据并将资产状态回滚到变更前状态，而不是卡在“变更中”。
4. 第四步：处理资源准备卡住问题。
  - 现象：资产申请流程到“资源准备”环节卡住。
  - 排查项：
    - 是否已完成服务授权。
    - 资源生成是否成功。
  - 解决方案：
    1. 进入申请单详情，查看“资源准备”标签页。
    2. 检查是否所有资源都已授权。
    3. 如果共享方式为“数据服务”，确认“服务授权”已完成。
    4. 补全资源后，点击“提交”完成资源准备环节。

# 场景三：待办任务收不到

高频现象：
1. 流程已经提交，但审批人收不到待办任务。
2. 审批人登录后在“我的待办”中看不到任务。
3. 会签节点部分审批人收不到任务。

排查步骤：

第一步：排除产品BUG。
- 操作：在官方补丁列表中，搜索关键词 待办、任务。
- 解决方案：
  - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
  - 2.若找到描述匹配的补丁，则申请并应用

第二步：检查角色授权。

操作：确认审批人拥有正确的角色。

各流程审批角色：

流程类型	审批节点	所需角色
资产发布流程	数据部门审批	资产管理员
资产变更流程	数据部门审批	资产管理员
资产申请流程	业务部门审批	资产部门管理员
资产申请流程	数据部门审批	资产管理员
问题上报流程	问题处理	资产管理员

解决方案：
- 租户管理员（admin）登录。
- 进入“应用中心” -> “权限管理” -> “角色管理”。
- 找到审批人账号，授予相应的角色（资产管理员/资产部门管理员）。
- 重新发起流程测试。

第三步：检查部门管理员配置。
- 现象：业务部门审批环节收不到任务。
- 排查项：资产所属部门是否有部门管理员。
- 解决方案：
  1. 进入“编目” -> “目录管理” -> “部门目录”。
  2. 确认资产所属的部门是否存在。
  3. 如果部门不存在，点击“重新同步”从AFCenter同步。
  4. 确认该部门下有员工拥有“资产部门管理员”角色。
  5. 如果部门下没有员工拥有该角色，则由资产管理员（dtadmin）代为审批。
第四步：检查会签节点配置。
- 现象：多部门资产申请时，部分部门审批人收不到任务。
- 排查项：会签节点配置是否正确。
- 解决方案：
  - 这是产品设计特性，一次申请多个资产会触发会签。
  - 需要所有涉及的部门管理员都审批通过才能进入下一步。
  - 确认所有涉及的部门都已配置部门管理员。

# 场景四：资产状态与流程不一致

高频现象：
1. 流程已审批通过，但资产状态仍为“审核中”。
2. 流程已作废，但资产仍可被检索到。
3. 资产变更流程完成后，资产内容未更新。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 状态、审核中、已发布。
  - 相关补丁示例：
    - DAMP_7.5.0_SERVER_20250902_P1（解决指标数据变更报错，指标流程相关）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：处理“发布后仍为审核中”问题。
  - 操作：检查流程完成后的回调逻辑。
  - 排查项：
    - BPS流程完成事件是否成功触发。
    - 资产状态更新SPI是否执行成功。
    - 是否有流程脏数据阻塞状态更新。
  - 解决方案：
    
    清理流程脏数据
```
-- 备份相关表
CREATE TABLE bfp_process_opinions_bak_yyyymmdd AS SELECT * FROM bfp_process_opinions;

-- 清理流程意见表中的脏数据（谨慎操作）
DELETE FROM bfp_process_opinions WHERE process_id = '具体流程ID';
```
    手动更新资产状态
```
-- 查看资产当前状态
SELECT id, name, status FROM rcm_catalog WHERE id = '资产ID';

-- 手动更新状态（STATUS: 0-草稿, 1-审核中, 2-已发布, 3-已下线, 4-已作废）
UPDATE rcm_catalog SET status = 2 WHERE id = '资产ID';
```
3. 第三步：处理“变更后状态卡住”问题。
  - 现象：变更流程完成后，资产内容未更新或状态异常。
  - 排查项：SPI实现是否有定制。
  - 解决方案：
    - 如果项目有源码定制，检查SPI接口实现逻辑。
    - 确认流程完成后调用资产更新接口是否成功。
    - 查看DAMP后台日志，搜索资产ID或流程ID相关日志。

# 场景五：批量操作流程异常

高频现象：
1. 批量发布资产时，部分资产发布失败。
2. 批量提交标准时，事务回滚。
3. 批量申请资产时，待申请列表异常。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 批量、发布、提交。
  - 相关补丁示例：
    - DAMP_7.5.0_SERVER_20250909_P1（解决批量关联主题域查不到资产，资产关联相关）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：处理批量发布失败。
  - 操作：检查失败资产的状态。
  - 排查项：批量发布只支持“草稿”状态的资产/标准。
  - 解决方案：
    - 筛选出状态为“草稿”的资产进行批量发布。
    - 已完成发布或审核中的资产不能再次批量发布。
3. 第三步：处理批量提交流失效率。
  - 现象：多个标准批量提交时，部分标准提交失败，报事务回滚。
  - 排查项：rcm_operation_log表的BUS_ID字段长度不足。
  - 解决方案：
```
-- 修改表结构，增加BUS_ID字段长度
ALTER TABLE rcm_operation_log MODIFY BUS_ID VARCHAR(1000);
-- 或改为TEXT类型
ALTER TABLE rcm_operation_log MODIFY BUS_ID TEXT;
```
4. 第四步：处理批量申请异常。
  - 现象：添加到待申请列表的资产，发起申请时异常。
  - 排查项：待申请列表数据损坏。
  - 解决方案：
    - 清空待申请列表。
    - 重新选择资产，添加到待申请列表。
    - 重新发起申请。

# 场景六：流程配置/参数问题

高频现象：
1. 流程走了错误的审批节点。
2. 指标发布不走流程。
3. 逻辑模型发布不走流程。

排查步骤：

第一步：检查平台参数配置。

操作：进入“技术门户” -> “配置中心” -> “平台参数”。
排查项：资产流程相关参数是否正确。

参数名	说明	默认值
`flow.asset_release`	资产发布流程	`com.primeton.data.dam.portal.flow.asset_release`
`flow.asset_chenge`	资产变更流程	`com.primeton.data.dam.portal.flow.asset_release`
`flow.asset_use`	资产申请流程	`com.primeton.data.dam.portal.flow.asset_apply`
`flow.assest_problem`	问题上报流程	`com.primeton.data.dam.portal.flow.assest_problem`
`metric.isOpenFlow`	指标审核流程开关	`Y`
`DAM_BUILD_MODEL.isOpenFlow`	模型发布流程开关	`Y`

解决方案：
- 确保参数值正确指向存在的流程定义ID。
- 如果逻辑模型发布不走流程，检查 DAM_BUILD_MODEL.isOpenFlow 是否为 Y。
- 如果指标发布不走流程，检查 metric.isOpenFlow 是否为 Y。

第二步：检查流程定义版本。
- 操作：进入“流程中心” -> “流程定义”。
- 排查项：
  - 流程定义是否存在。
  - 流程版本是否为“已发布”状态。
  - 是否有多个版本导致混乱。
- 解决方案：
  - 如果流程定义不存在，重新导入流程包。
  - 将正确的流程版本设为默认版本。
  - 停用旧版本。
第三步：检查流程开关配置。
- 现象：逻辑模型发布不走流程，点击发布后直接发布。
- 操作：进入“技术门户” -> “配置中心” -> “平台参数”。
- 排查项：DAM_BUILD_MODEL.isOpenFlow 参数是否设置为 Y（开启流程）。
- 解决方案：如果设置为 N，修改为 Y 后点击“刷新缓存”。

← 与数据质量对接相关功能排查指南数据资产系统管理相关问题排查指南 →