故障排除

如果遇到安装或升级问题，请考虑以下故障排除方案：

与缓存的旧版 UiPath CLI 版本相关的问题

平台：CloudBees

说明：此问题涉及 CloudBees 软件升级。升级后，内部缓存的uipcli版本无法更新，从而导致旧版uipcli仍处于缓存状态。这将导致提取后找不到tools文件夹。

Remedy:

要解决此问题，您必须强制安装 UiPath.CLI.Windows.nupkg 或 UiPath.CLI.nupkg。您可以使用与以下示例中的代码片段类似的代码片段执行此操作：

UiPathInstallPlatform(                        cliNupkgPath: 'C:\\Users\\uipathadmin\\CLIVersions\\UiPath.CLI.Windows.23.10.8894.39673.nupkg',                        cliVersion: 'X_23.10.8753.32995',                        forceInstall: true,                        traceLevel: 'Information'                    )

请注意，cliNupkgPath 是指代理计算机上缓存的 uipcli 的位置。

此外，在上面的示例中，将 cliVersion 设置为 X_23.10.8753.32995 以强制 UiPathInstallPlatform 从 cliNupkgPath 中提取，从而避免从内部 .jar 文件中提取旧版。

最后，确保您的 uipath-automation-package 插件版本至少为 3.1（建议为 3.2），如果要提取 Windows uipcli，则代理必须是 Windows 计算机。

未经授权的错误

说明：发生未经授权的错误。

Remedy:

• 如果使用基本身份验证：请确保网页登录上的用户名-密码组合正确无误。如果启用了联合身份验证，请确保在任务中将用户名写为“域\用户”
• 如果使用令牌身份验证：
  • 从 API 访问面板撤消令牌并生成新令牌。
  • 确保生成密钥的用户可以访问 Orchestrator，并且在 Orchestrator 实例上拥有用户帐户。
• 如果您对内部部署 Orchestrator 进行身份验证：请确保 Orchestrator 证书有效，并且如果您使用自签名证书，则运行作业的计算机信任 Orchestrator 证书。您可能会收到此错误，因为用于 Orchestrator 的证书无效。这可能意味着它存在 CN 错误或其他验证问题。

禁止的错误

补救措施：用户没有执行此操作的权限。确保用户有权读取文件夹、上传包、创建和更新流程、读取测试集和测试用例、读取后台任务以及创建和运行测试集。

未找到文件夹/环境

补救措施：确保 CI/CD 插件使用的经过身份验证的用户具有Folders.View和BackgroundTask.View （仅适用于 20.4）权限。

包已存在 (冲突)

补救措施：确保您尝试部署的包中不存在具有相同版本的包。如果存在包版本，请考虑使用自动包版本控制功能，以便每次部署时都能升级新版本。

运行命令失败 (一般错误)

补救措施：如果 Jenkins 工作区位于用户没有权限的磁盘上位置（例如C:\Windows or C:\Program Files ），请确保该工作区位于用户可以访问的路径上。

Jenkins 无法处理包含非拉丁字符的路径

补救措施：调用 UiPath 插件时，Jenkins 无法正确传递非标准编码字符。未知字符将替换为??? 。

解决方案取决于在服务器和代理主机上部署 Jenkins 的方式，但涉及将Java选项中的file.encoding设置为 UTF-8：

Windows

在 Windows 上作为服务运行 Jenkins 时：在服务配置文件中，在标签内添加参数。 请按照以下示例脚本操作。

<arguments>-Xrs -Xmx512m -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -Dfile.encoding=UTF-8 -jar "%BASE%\)\)jenkins.war" --httpPort=8080 --webroot="%BASE%\)\)war"</arguments>

在 Docker 中运行 Jenkins 时：按照下面的示例脚本，通过--env JAVA_OPTS="..."将JAVA\_OPTS传递给容器。

docker run --name myjenkins -p 8080:8080 -p 50000:50000 --env JAVA_OPTS=-Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -Dfile.encoding=UTF-8 jenkins/jenkins:lts

在 Tomcat 中运行 Jenkins 时：使用环境变量CATALINA_OPTS 。 请按照以下示例脚本操作。

export CATALINA_OPTS="-DJENKINS_HOME=/path/to/jenkins_home/ -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -Dfile.encoding=UTF-8 -Xmx512m"

Linux

在基于 Debian 或 Ubuntu 的 Linux 发行版上运行时：在配置文件中搜索参数JAVA_ARGS ，并添加文件编码。 请按照以下示例脚本操作：

JAVA_ARGS="-Dfile.encoding=UTF-8 -Xmx512m"

在基于 RedHat Linux 的发行版上运行时：在配置文件中搜索参数JENKINS\_JAVA\_OPTIONS并添加文件编码。按照下面的示例脚本进行操作。

JENKINS_JAVA_OPTIONS="-Dfile.encoding=UTF-8 -Xmx512m"