数据校验节点
连接流「数据校验」节点
本文介绍连接流中「数据校验」节点（Guard 节点）的配置与使用方法，帮助流程开发者实现数据质量前置校验，避免脏数据导致流程中断。
概述
前提条件
节点基础信息
| 属性 | 说明 |
|---|---|
| 节点名称 | 数据校验 |
| 所属应用 | 运维处理 |
| 节点描述 | 对输入数据进行前置校验，拦截不符合规则的脏数据，避免流程运行时报错中断 |
操作步骤
步骤 1：添加数据校验节点
1.
2.
步骤 2：添加校验规则
点击「+ 添加校验规则」按钮，为每条规则配置以下参数：
| 配置项 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 字段路径 | 文本输入框 | 是 | 通过左侧变量面板选择或手动输入需校验的字段路径 |
| 校验规则类型 | 下拉选择框 | 是 | 选择校验类型，详见下方校验类型说明 |
| 失败处理方式 | 下拉选择框 | 是 | Error（终止流程）/ Warning（记录告警但继续执行） |
| 错误提示 | 文本输入框 | 否 | 自定义校验失败时的提示信息 |
步骤 3：选择校验规则类型
根据业务需求选择合适的校验类型，详见下方「校验类型详细说明」章节。
步骤 4：配置失败处理方式
为每条规则选择校验失败后的处理方式：Error（默认）：关键校验，失败时终止流程，适用于必须满足的核心字段 Warning：非关键校验，失败时记录告警但继续执行，适用于非核心字段的辅助校验
校验类型详细说明
必填校验
数据类型校验
枚举校验
数值范围校验
校 验字段必须存在且不为 null、undefined、空字符串。
| 字段情况 | 校验结果 |
|---|---|
字段不存在 / 值为 null / undefined / "" | 失败 |
值为 0、false、[]、{} | 通过 |
说明：选择此类型后无需额外配置，直接生效。
失败处理方式对比
Error（默认）关键校验，失败时终止流程。适用于必须满足的核心字段。节点输出
_guardStatus: "failed"。Warning非关键校验，失败时记录告警但继续执行。适用于非核心字段的辅助校验。节点输出
_guardStatus: "warning"。规则管理操作
| 操作 | 说明 |
|---|---|
| 添加规则 | 点击「+ 添加校验规则」按钮，新增一条空白规则 |
| 删除规则 | 点击规则卡片右上角的删除图标 |
| 调整顺序 | 拖拽规则卡片调整执行顺序 |
节点输出说明
输出字段
| 字段 | 类型 | 说明 |
|---|---|---|
_guardStatus | String | 校验状态：passed / warning / failed |
_guardErrors | Array | Error 级别的校验失败详情，仅 failed 时存在 |
_guardWarnings | Array | Warning 级别的校验失败详情 |
| 其他字段 | Any | 原始输入数据平铺输出 |
错误/警告详情结构
| 字段 | 类型 | 说明 |
|---|---|---|
field | String | 失败字段路径 |
rule | String | 触发规则类型：required / type / enum / range |
message | String | 错误描述（优先使用自定义提示） |
expected | Any | 期望值或规则要求 |
actual | Any | 字段实际值 |
输出示例
校验通过
存在警告
校验失败
{
"_guardStatus": "passed",
"_guardWarnings": [],
"order_id": "ORD-2025-001",
"amount": 1500.00,
"status": "paid"
}边界情况处理
| 情况 | 处理方式 |
|---|---|
| 字段不存在或为 null/undefined | 类型/枚举/范围校验跳过（如需必填请单独配置必填规则） |
数字字符串如 "123" | 类型校验为 number 时失败，不自动转换 |
NaN 或 Infinity | 类型校验为 number 时失败 |
| 枚举列表为空 | 配置阶段阻止保存 |
| 最小值大于最大值 | 配置阶段阻止保存 |
常见问题
修改于 2026-05-07 04:46:44