验证相等

验证相等 用于比较两个数值是否相等，并输出验证结果（true/false）。它支持整数和小数，常用于数据处理结果校验、自动化测试断言和流程分支判断。

指令标识：VerifyEqual
指令类型：通用指令
指令描述：该指令用于验证两个数值是否相等，支持整数和小数的比较验证

先选使用方式

工作流支持「可视化编排」和「代码编排」两种创建方式。验证相等 在两种方式里都能用，核心业务参数一致，区别主要是你通过界面配置，还是通过 Python 脚本配置。

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「验证相等」节点，在右侧表单填写实际值、期望值和失败处理方式	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 bots.verifyEqual(actualNumber=100, expectedNumber=100, outKey="equalResult")	熟悉代码、需要复用脚本或批量生成流程的用户

第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。下方「参数说明」同时给出界面字段和代码参数名，方便两种方式对应。

什么时候用？

• 需要验证计算结果、统计数量或金额是否符合预期。
• 自动化测试中需要对数值结果做断言。
• 流程中要根据两个数值是否相等决定后续分支。
• 需要比较变量中的实际值和预设的期望值。

使用前确认

• 「实际值」和「期望值」都必须是有效数字，支持整数和小数。
• 如果使用变量引用，请确认变量值最终能解析为数字，例如 ${totalCount}。
• 已规划好验证失败时的处理方式：输出结果继续流程，或抛出异常中断流程。
• 如需控制是否发送节点消息，可按流程日志需要设置「是否发送消息」。

可视化编排：从 0 到跑通

下面用一个常见场景演示：验证后台列表统计数量是否等于期望数量。按 4 步即可跑起来：

1. 先通过前置节点获取实际数量，并保存为变量，例如 actualCount。
2. 添加 验证相等 节点。
3. 在 实际值 和 期望值 中填写：

${actualCount}

100

4. 设置 将结果保存至 为 equalResult，点击运行，确认结果为 true 或 false。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
实际值	actualNumber	Double	是	-	需要进行比较验证的实际数值，实际值不能为空，仅支持数字类型，例如 10
期望值	expectedNumber	Double	是	-	与实际值进行比较的期望数值，期望值不能为空，仅支持数字类型，例如 10
False结果处理	falseResultHandling	Enum	否	OUTPUT_RESULT	高级选项。验证结果为 False 时的行为：OUTPUT_RESULT(输出结果，继续流程)、THROW_EXCEPTION(抛出异常，中断流程)
是否发送消息	sendMsgFlag	Boolean	否	True	是否发送节点消息

输出参数

界面名称	代码属性名	类型	必填	说明
将结果保存至	outKey	Boolean	否	验证结果的存储变量名，返回 true 或 false，例如 equalResult

成功标准

• 节点运行成功，日志中没有异常。
• 输出变量得到布尔结果：true 表示两个数值相等，false 表示两个数值不相等。
• 当 falseResultHandling 为 THROW_EXCEPTION 时，不相等会抛出异常并中断流程。
• 当 falseResultHandling 为 OUTPUT_RESULT 时，不相等会输出 false 并继续后续流程。

运行后你会看到（以上面场景为例）：

• 如果 actualCount 为 100，输出变量 equalResult 为 true。
• 如果 actualCount 不是 100，输出变量 equalResult 为 false，或根据失败处理配置抛出异常。

失败排查

现象 / 报错原文	可能原因	处理建议
结果为 false	实际值与期望值不相等	检查前置计算或采集结果；确认期望值是否正确
输入值不是有效数字	参数传入了文本、空值或无法解析的变量	确认 actualNumber 和 expectedNumber 最终都是数字
验证失败直接中断流程	falseResultHandling 设为 THROW_EXCEPTION	如需继续执行，改用 OUTPUT_RESULT
变量引用没有生效	变量名写错或变量未赋值	检查 ${variableName} 是否与前置节点输出变量一致
小数比较结果不符合预期	上游计算存在精度或格式差异	在前置步骤中统一数值精度或四舍五入后再比较

Python 代码编排

代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。

# 验证后台列表统计数量是否等于期望数量
bots.verifyEqual(
    actualNumber=100,
    expectedNumber=100,
    falseResultHandling="OUTPUT_RESULT",
    outKey="equalResult",
)

可视化表单里的「实际值」「期望值」「False结果处理」「将结果保存至」分别对应代码里的 actualNumber、expectedNumber、falseResultHandling、outKey。

如果你想在工作流中通过节点动态编排指令，可使用 执行指令（XML）节点。

常见问题

Q1：该指令的返回结果是什么类型？

A： 返回结果为布尔值（Boolean）。true 表示两个数值相等，false 表示两个数值不相等。

Q2：是否支持浮点数比较？

A： 是的。该指令支持整数和小数的比较验证，使用精确的数值计算确保比较结果的准确性。

Q3：如果输入值不是数字会怎样？

A： 如果输入值不是有效的数字，指令会抛出异常。请确保输入的是有效的数字类型或数字字符串。

Q4：该指令是否支持变量引用？

A： 是的。该指令支持变量引用，可以使用 ${variableName} 的方式引用变量值作为参数。

Q5：False结果处理如何使用？

A： 该参数用于控制验证失败场景下的执行行为，支持两种策略（括号内为需传入的参数值）：

• 输出结果（OUTPUT_RESULT，默认）：验证失败时输出 false 结果到 outKey，继续执行后续流程。
• 抛出异常（THROW_EXCEPTION）：验证失败时抛出异常，中断当前流程执行。

相关指令

• 验证不相等
• 验证大于
• 验证小于
• 条件判断