验证当前页面所有可访问链接

验证当前页面所有可访问链接 用于自动检测当前页面上的所有链接是否可正常访问，并输出验证结果（True/False）。它常用于页面链接完整性检查、网站健康度检测、死链检测等场景。

指令标识：VerifyPageAllLinksAccess
指令类型：网页指令
指令描述：验证当前页面上的所有链接均可访问

先选使用方式

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

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「验证当前页面所有可访问链接」节点，按需配置是否包含外部链接、排除链接	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 `bots.verifyPageAllLinksAccess(outKey="output")`	熟悉代码、需要复用脚本或批量生成流程的用户

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

什么时候用？

检查页面链接的完整性，确保没有死链影响体验。
进行网站健康度检测，定期校验链接可达性。
做 SEO 链接验证，确保链接健康状态。
在自动化回归测试中验证页面更新后链接完整性未受影响。

使用前确认

浏览器已打开目标页面（通常先执行打开网页）。
页面已加载完成，链接已全部渲染。
已确认是否需要包含外部链接（外部链接验证可能较慢）。
如有需要忽略的链接，已准备好排除链接列表。

可视化编排：从 0 到跑通

下面用一个常见场景演示：打开页面后检测所有链接是否可访问。按 3 步即可跑起来：

先添加打开网页节点，打开目标页面：

https://example.com

添加 验证当前页面所有可访问链接 节点，按需设置 包含外部链接，并设置输出变量名。
点击运行，确认输出变量得到 true（全部可访问）或 false（存在不可访问链接）。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
包含外部链接	`includedExternalLink`	Boolean	否	`true`	是否包含外部链接（非当前域名的链接）。高级选项。
排除链接	`excludedLinks`	`List<String>`	否	`[]`	排除的链接（URL）列表，支持字符串数组。高级选项。
False结果处理	`falseResultHandling`	Enum	否	`OUTPUT_RESULT`	验证结果为 False 时的处理方式：`OUTPUT_RESULT`（输出结果，默认）、`THROW_EXCEPTION`（抛出异常）。高级选项。

输出参数

界面名称	代码属性名	类型	必填	说明
将结果保存至	`outKey`	Boolean	否	填写变量名称（如 `linksAccess`），保存验证结果（`true`/`false`）。

成功标准

节点运行成功，日志中没有异常。
输出变量得到布尔结果：true 表示所有链接均可访问，false 表示存在无法访问的链接。
设为抛出异常时，验证失败会中断流程；设为输出结果时，会继续执行后续节点。

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

输出变量得到 true（全部链接可访问）或 false（存在死链）。
运行日志显示验证执行成功。

失败排查

现象 / 报错原文	可能原因	处理建议
结果为 `false`	页面存在无法访问的链接	查看日志中失败的链接，确认是否死链或临时不可达
验证耗时过长	包含了大量外部链接	仅需验证内部链接时，将 `includedExternalLink` 设为 `false`
误报某些链接失败	这些链接本就不需要校验	通过 `excludedLinks` 排除指定链接
验证失败直接中断流程	`falseResultHandling` 设为抛出异常	如需继续执行，改用 `OUTPUT_RESULT`

Python 代码编排

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

# 打开页面后，验证页面所有链接是否可访问，结果保存到 output
bots.openUrl(url="https://example.com")
bots.verifyPageAllLinksAccess(
    includedExternalLink=True,
    falseResultHandling="OUTPUT_RESULT",
    outKey="output",
)

仅校验内部链接，并排除指定链接：

bots.verifyPageAllLinksAccess(
    includedExternalLink=False,
    excludedLinks=["https://example.com/skip-a", "https://example.com/skip-b"],
    outKey="output",
)

可视化表单里的「包含外部链接」「排除链接」「False结果处理」「将结果保存至」分别对应代码里的 includedExternalLink、excludedLinks、falseResultHandling、outKey。如果你想在工作流中通过节点动态编排指令，可使用执行指令（XML）节点。

常见问题

Q1：返回 true 表示什么？

A：返回 true 表示所有链接均可访问；返回 false 表示存在无法访问的链接。

Q2：如何排除特定链接？

A：使用 excludedLinks 参数指定要排除的链接，例如：excludedLinks=["https://example.com/a","https://example.com/b"]。

Q3：外部链接验证会很慢吗？

A：是的。外部链接验证可能耗时较长，建议按需选择。仅需验证内部链接时，设置 includedExternalLink=False。

Q4：如果页面没有链接会怎样？

A：如果页面没有链接，验证会返回 true。

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

A：该参数用于控制验证失败时的执行行为（括号内为需传入的参数值）：

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