验证图片不包含文本

验证图片不包含文本 用于判断一张图片中是否「没有」出现指定的文字。它先对图片做 OCR 文字识别，再检查识别结果中是否不含目标文本，不含则返回 true，否则返回 false，常用于负向断言、敏感文案检测等场景。

指令标识：VerifyImageNotContainsText
指令类型：验证指令
指令描述：对图片做 OCR 识别后验证是否不包含指定文本，不包含返回 true，否则返回 false，结果保存到指定变量

先选使用方式

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

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「验证图片不包含文本」节点，在右侧表单填写图片地址和待校验文本	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 bots.verifyImageNotContainsText(imageUrl="...", text="...", outKey="result")	熟悉代码、需要复用脚本或批量生成流程的用户

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

什么时候用？

• 需要确认某张截图中「没有」出现某段文字（如错误提示、敏感词等）。
• 做负向断言，验证不该出现的文案确实没有出现。
• 元素文本无法通过 DOM 获取，只能从图片中识别后反向校验。

如果你要确认文本「存在」，请使用 验证图片包含文本。

使用前确认

• 已经准备好图片地址，且地址在当前执行环境可访问。
• 图片中的文字清晰、不被遮挡，分辨率足够，避免 OCR 识别遗漏导致误判。
• 待校验文本与图片中文字的写法一致（注意全半角、空格、大小写）。
• 已规划好用于保存结果的输出变量名。

可视化编排：从 0 到跑通

下面用一个常见场景演示：校验截图中没有出现”系统异常”提示。按 4 步即可跑起来：

1. 在工作流画布中添加 验证图片不包含文本 指令。
2. 在右侧配置面板填写 图片地址 和 待校验文本：

图片地址：https://example.com/assets/screenshots/result.png
待校验文本：系统异常

3. 在 将结果保存至 填写变量名，例如 notContainsText。
4. 点击运行，输出变量为 true 表示图片中没有识别到”系统异常”。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
图片地址	imageUrl	String	是	-	待识别的图片地址，需可被执行环境访问。
待校验文本	text	String	是	-	要确认在图片识别结果中不存在的文本。
False结果处理	falseResultHandling	String	否	输出结果	验证失败时的处理方式，可选 输出结果、抛出异常。

输出参数

界面名称	代码属性名	类型	必填	说明
将结果保存至	outKey	Boolean	是	保存验证结果的变量名，返回 Boolean：true 表示图片中不包含该文本，false 表示识别到了该文本。

成功标准

• 验证图片不包含文本 节点运行结束后状态为成功。
• 运行日志中没有参数缺失、超时或执行失败等错误。
• 如果配置了输出变量，后续节点能够读取到符合预期的结果。
• 后续节点能够继续执行，流程没有因为该节点异常中断。

失败排查

现象 / 报错原文	可能原因	处理建议
日志报 VerifyImageNotContainsText: imageUrl 不能为空	图片地址未填写	检查「图片地址」是否填写；代码编排确认 imageUrl 已传入
日志报 VerifyImageNotContainsText: text 不能为空	待校验文本未填写	检查「待校验文本」是否填写；代码编排确认 text 已传入
日志提示 ocr.recognition.url 未配置，无法验证，返回 false	OCR 识别服务地址未配置	联系管理员检查执行环境的 OCR 服务配置
日志报 OCR 返回结果不是合法 JSON	OCR 服务返回异常	重试或联系管理员检查 OCR 服务可用性
结果与预期相反	文字模糊导致漏识别，或文本写法不一致	提高图片清晰度，核对全半角、空格与大小写

Python 代码编排

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

# 验证图片中不包含指定文本，结果保存到 notContainsText
bots.verifyImageNotContainsText(
    imageUrl="https://example.com/assets/screenshots/result.png",
    text="系统异常",
    outKey="notContainsText",
)

验证失败（即识别到了该文本）时如果希望直接中断流程，可将处理方式设为抛出异常：

bots.verifyImageNotContainsText(
    imageUrl="https://example.com/assets/screenshots/result.png",
    text="系统异常",
    falseResultHandling="THROW_EXCEPTION",
    outKey="notContainsText",
)

可视化表单里的「图片地址」「待校验文本」「将结果保存至」分别对应代码里的 imageUrl、text、outKey。

常见问题

Q1：返回 true 代表什么？

A： 代表 OCR 识别结果中没有出现「待校验文本」，即「确认不包含」。

Q2：OCR 服务未配置时会怎样？

A： 当识别服务地址未配置时，无法完成识别，指令会按未通过处理，将结果置为 false，请联系管理员检查执行环境配置。

Q3：False 结果处理怎么用？

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

相关指令

• 验证图片包含文本
• 验证图片不包含目标截图
• OCR 文字识别
• 验证字符串不匹配