故障排除

本页介绍了 UiPath Chrome 扩展程序可能无法正常工作的常见原因，以及针对这些问题的解决方案。

请注意，目前可以在单个 Chrome 窗口中通过 Chrome 扩展程序实现浏览器自动化。

备注：

您需要使用版本最低为 64 的 Google Chrome 才能进行浏览器自动化。

检查 Chrome 扩展程序是否已安装并启用

1. 在 Google Chrome 中，导航到 chrome://extensions/。

2. Make sure the extension is installed and enabled, as explained here.

3. If the extension was installed correctly but does not appear in Chrome, check if there are Group Policies that affect the extension, as explained here.

   

   备注：

   Selecting the Developer mode check box at the top of the chrome://extensions/ page displays the Update button on the extension Details page.

检查 ChromeNativeMessaging.exe 是否正在运行

ChromeNativeMessaging.exe 支持 UiPath Chrome 扩展程序与 UiPath Studio/UiPath Robot 之间的通信。

1. 打开 Chrome。

2. 打开任务管理器。

3. 检查 ChromeNativeMessaging.exe 进程是否正在运行：

   

4. 如果该进程未运行：

   • Make sure the extension is installed. For more information on how to install it, check the docs page.
   • Check if there are Group Policies affecting ChromeNativeMessaging.exe. See the docs page for more information.
   • Check if the ComSpec environment variable is defined correctly.

If the information above did not solve your issue, you can try getting additional information by viewing traces and analyzing the errors thrown by the UiPath extension. The following are types of traces you can collect and analyze: Enabling Traces.

启用追踪

Google Chrome 中常规扩展程序追踪

1. 在 Google Chrome 中，转到 chrome://extensions/。

2. 选中网页顶部的“开发人员模式”复选框。

3. 转到 UiPath 扩展程序并单击背景页面。系统将显示“开发人员工具”页面。

4. 导航到“控制台”选项卡。扩展程序生成的所有追踪都显示在这里。

   备注：

   错误以红色标记。

您要自动化的网页生成的踪迹

1. 在您要自动化的网页上，转到“侧导航栏”>“更多工具”>“开发人员工具”（或按 Ctrl+Shift+I）。系统将显示由 UiPath 扩展程序为当前页面生成的追踪。

   备注：

   错误以红色标记。

完整追踪

1. 打开注册表编辑器。

2. 导航到 HKEY_CURRENT_USER\SOFTWARE\UiPath 键。

3. 双击“WebExtensionTrace”DWORD 值。系统将显示“编辑 DWORD 值”窗口。

4. 在“值数据”字段中，将值更改为 1，然后单击“确定”。值即已保存。

   备注：

   如果“网页扩展程序追踪”DWORD 值不存在，则必须创建此值，方法是在右侧面板中单击右键，选择“新建”>“DWORD (32 位)值”，然后提供上述值。

   If the extension for Chrome is still not working, remove the extension from chrome://extensions/ and reinstall it.

检查 ComSpec 变量是否已正确定义

描述

ChromeNativeMessaging.exe 进程在当前用户下运行，并使用 cmd.exe 启动浏览器。

如果 ComSpec 环境变量缺失或具有无效值，则 Google Chrome 无法启动 ChromeNativeMessaging.exe。

此外，管理员可以为某些用户禁用命令提示符，或将其配置为始终以高权限运行。

解决方案

解决方案是为 ComSpec 环境变量手动添加正确的值。此变量在 Windows 安装时设置，其值应为 %SystemRoot%\system32\cmd.exe。

其他解决方法

如果 ComSpec 环境变量设置正确，但问题仍然存在，则用户可能没有运行命令提示符的权限。在这种情况下，ChromeNativeMessaging.exe 流程无法通过在当前用户下运行的 cmd.exe 启动。

Starting with Chromium 120.0.6090+, a NativeHostsExecutablesLaunchDirectlyGroup Policy allows admins to turn this on for users in restricted environments (Cloud PCs that forbid cmd.exe, for example).

启用对文件 URL 和隐身模式的访问权限

默认情况下，该扩展程序未被授予访问文件 URL 或隐身模式的权限。要启用这些权限：

1. 在 Google Chrome 中，导航到 chrome://extensions/。Chrome 扩展程序页面随即显示。

2. 导航到 UiPath 网页自动化扩展程序，然后单击“详细信息”按钮。系统将显示“UiPath 网页自动化”详细信息页面。

3. 确保选中了“允许匿名”和“允许访问文件 URL”选项。

   

多个浏览器配置文件

具有多个用户配置文件的多个 Chrome 实例

UiPath Chrome 扩展程序不支持同时自动化使用多个用户配置文件运行的多个浏览器实例。因此，浏览器自动化要求您关闭 Chrome 的所有活动实例，并使用单个用户配置文件重新启动浏览器。

停止所有 Chrome 实例

在某些情况下，Chrome 后台进程会阻止其完全关闭，即使浏览器实例不可见，这也会干扰自动化。

我们建议通过右键单击系统托盘中的 Chrome 图标，然后选择“退出”来关闭 Chrome。这样可以确保后台不再使用其他用户配置文件。

特定于 MV3 扩展程序的已知问题

在特定网页元素上使用“模拟”的“单击”活动失败

使用 Simulate 输入方法的“单击”活动不再适用于具有带 javascript: URI 的单击处理程序的 HTML 元素：

在这种情况下，模拟点击将不会生效，也不会报告任何错误。

This was reported as a Chromium bug here: https://bugs.chromium.org/p/chromium/issues/detail?id=1299742 This issue is quite rare as very few HTML elements have click handlers in this form.

解决方法

将失败的“单击”活动的输入方法从 Simulate 更改为任何其他输入方法：

• Chromium API
• 硬件事件
• 窗口消息

“开发者工具可用性”组策略值必须设置为 1

开发者工具可用性具有以下可能的值：

• 0 = 不允许在企业策略安装的扩展程序上使用开发者工具，允许在其他上下文中使用开发者工具
• 1 = 允许使用开发者工具
• 2 = 禁止使用开发者工具

If the UiPath Extension for Chrome is installed using Group Policy, then the DeveloperToolsAvailability must be set to 1 to enable the full functionality of the extension.

安装扩展程序时，系统会自动正确设置此值，但如果系统管理员为此策略设置了其他值，则系统会覆盖此值。

“开发者工具可用性”的其他值会导致下面列出的问题。

如果 DeveloperToolsAvailability 设置为 0，则：

• UiPath Chrome 扩展程序 v22.4 根本无法使用此限制。请考虑升级到随 UiPathStudio.msi 2022.4.4 提供的扩展程序的 v22.10。
• UiPath Chrome 扩展程序 v22.10 将仅限使用 LTS 版本的 UIAutomation（19.10.x、20.10.x、21.10.x、22.4.x）
• InjectJS 活动将不起作用。

如果 DeveloperToolsAvailability 设置为 2，则：

• DeveloperToolsAvailability=0 中的所有限制均适用
• ChromiumAPI 输入方法将不起作用。

UiPath 网页自动化浏览器窗口显示警告

如果无法启动 ChromeNativeMessaging.exe，UiPath 网页自动化浏览器窗口将显示以下警告：

Cannot communicate with UiPath Platform The native part of the extension is not configured correctly.

从 UiPath Studio 中重新安装扩展程序。

See Check If ChromeNativeMessaging.exe Is Running.

“打开浏览器”活动的超时时间不足

For MV3 extensions, the browser loads the extension later, after the web pages have loaded. This means that on slower machines, the Open Browser activity from UiPath.UiAutomation.Activities version 20.10 or older can reach the internal timeout of 20 seconds before the extension has started.

Starting with v20.10.13, the internal timeout for the Open Browser activity has been increased from 20 seconds to 60 seconds.

此外，您可以通过 UIPATH_OPEN_BROWSER_TIMEOUT_SECONDS 环境变量配置超时。 例如，将 UIPATH_OPEN_BROWSER_TIMEOUT_SECONDS=120 设置为使用 120 秒作为活动的超时时间。