产品文档
监视
查看 PDF

会话启动诊断

May 4, 2026
投稿者: 
C C

注意：

会话启动诊断目前处于预览阶段。

会话启动涉及多个 Citrix 组件。要诊断会话启动失败，请使用 Citrix Monitor（即 Citrix Director 服务）将问题缩小到发生问题的确切组件和阶段。应用建议的操作来解决此问题。Citrix Workspace™ app 会生成一个 32 位（8-4-4-4-12）事务 ID，可用于诊断会话启动失败。

注意：

此功能仅适用于美国、AP-S 和欧盟区域的云客户。在日本和政府区域不可用。

先决条件

如果您使用的是 Citrix DaaS™，则载入是自动的。使用本地 StoreFront 的云客户必须确保已载入受支持的 StoreFront 版本。

  • 如果您使用的是 Citrix Analytics for Performance，请参阅数据源以了解载入本地 StoreFront 的步骤。

  • 如果您未使用 Citrix Analytics for Performance™：

    1. 转至 https://analytics.cloud.com/unified-datasources/perf/Citrix%20Virtual%20Apps%20and%20Desktops/site-details。
    1. 单击连接到 StoreFront 部署，输入详细信息，然后下载配置文件。有关详细信息，请参阅使用 StoreFront 载入本地站点。

注意：

具有云管理员角色的管理员可以载入 StoreFront™ 部署，而具有完全监视管理员角色的管理员只能查看 StoreFront 部署。

其他组件的最低支持版本如下：

  • 适用于 Windows 的 Citrix Workspace app 2109
  • 适用于 Mac 的 Citrix Workspace app 2112
  • 适用于 Linux 的 Citrix Workspace app 2112
  • 适用于 HTML5 的 Citrix Workspace app 2110
  • 适用于 Chrome 的 Citrix Workspace app 2110
  • 适用于 Android 的 Citrix Workspace app 2110
  • VDA 版本 Citrix Virtual Apps and Desktops™ 2112
  • Citrix StoreFront 1912 LTSR CU4

诊断会话启动失败的步骤

    1. 从 Citrix Workspace app 复制失败会话启动的事务 ID。

    复制事务 ID

    1. 在 Monitor UI 中，搜索 32 位事务 ID，然后单击详细信息。

  • 使用事务 ID 搜索

    1. 如果事务 ID 不可用，请使用用户名进行搜索。将显示用户的活动管理器。
  • 使用用户名搜索

  1. 单击会话选择器。转至失败的会话选项卡。将显示过去 48 小时内失败的会话列表。单击选定的会话。

    使用用户名搜索

  2. Citrix Monitor 显示有关该事务的组件、错误详细信息和事务日志详细信息。

    会话启动监视器页面

上一个屏幕显示以下部分：

  • 组件
  • 错误详细信息
  • 事务日志

组件

根据会话启动方案和失败阶段，会话中涉及的组件可以是以下任意一项：

  • 端点
  • Citrix Workspace
  • Citrix DaaS
  • Cloud Connector
  • Gateway Service
  • VDA

  • StoreFront

  • 突出显示的错误

上图中突出显示了发生故障的组件。

  • 注意：

    • 事务组件由收到的会话启动事件确定。如果故障发生在过程的早期，或者未收到事件，则可能不会显示某些组件。例如，如果错误发生在 Citrix Workspace app 和 Citrix Workspace 之间的通信中，则组件将仅为端点和 Citrix Workspace。

    • 在某些极端情况下，事务可能被视为失败，但如果没有收到失败事件，则不会报告任何错误。

    • 客户端错误代码和诊断信息仅在 Citrix StoreFront 载入并发送数据时可用。有关载入 StoreFront 的详细信息，请参阅先决条件。这是未报告失败会话错误的原因之一。

  • 错误详细信息

错误详细信息突出显示给定组件中发生的问题。将显示错误描述、错误代码和建议的操作。

  • 错误详细信息

注意：

本节仅显示错误的根本原因，而不显示原始事件中的所有单个错误。有关单个日志，请参阅事务日志。

  • 事务日志

事务日志提供原始会话启动事件，从而提供连接中涉及的组件的端到端跟踪。

  • 事务日志

  • 错误代码

Broker 代理

  • bka.prepare.session.failure.validation

  • 描述：未能验证准备会话请求。

  • 建议操作：重试操作。如果故障重复出现，请检查连接器是否处于正常运行状态。

  • bka.prepare.session.failure.rejected

  • 描述：VDA 无法接受启动请求。
  • 建议操作：在 VDA 上重新启动 Citrix Delivery Agent 服务或重新启动 VDA。

bka.hdx.prepare.failure.general

  • 描述：HDX™ 准备失败。

  • 建议操作：重新启动 VDA。

  • bka.hdx.validate.failure.ticket_not_found

  • 描述：引用的票证或启动不在启动缓存中。

  • 建议操作：确保 VDA 可以与连接器通信。

  • bka.ticketing.validate.failure.unlicensed

  • Description: 无法验证启动许可证。
  • Recommended Action: 请联系 Citrix 支持。

bka.ticketing.validate.failure.general

  • Description: 验证票证时发生一般性故障。

  • Recommended Action: 在 VDA 上收集日志并联系 Citrix 支持。

  • bka.set.configuration.failure.policy

  • Description: 设置策略时发生错误。
  • Recommended Action: 在 VDA 上重新启动 Citrix Delivery Agent 服务或重新启动 VDA。

bka.set.configuration.failure

  • Description: 设置配置时发生错误。

  • Recommended Action: 在 VDA 上重新启动 Citrix Delivery Agent 服务或重新启动 VDA。

  • Broker

  • brk.validate.credentials.failure.invalid

  • Description: 由于某些问题，凭据验证失败。具体原因可在消息参数中展开。
  • Recommended Action: 重试操作。如果故障重复出现，请检查连接器是否处于正常运行状态。

brk.resolve.machine.failure.general

  • Description: 枚举或解析工作程序失败。具体原因可在消息参数中展开。

  • Recommended Action: 确保能够启动此应用程序的计算机已向 Broker 注册。确保所有可用计算机均未达到其容量上限。

  • brk.license.check.failure.constraints

  • Description: 许可限制导致会话启动失败。

  • Recommended Action: 确保此类型的应用程序或桌面有可用许可证。

  • brk.resolve.machine.failure.timeout

  • Description: Broker 在联系数据库时超时。
  • Recommended Action: 与站点数据库通信时出现问题。请联系 Citrix 支持。

brk.poweron.forlaunch.queued.failure.general

  • Description: 排队电源操作失败。

  • Recommended Action: 与站点数据库通信时出现问题。请联系 Citrix 支持。

  • brk.set.configuration.failure.general

  • Description: 在目标 VDA 上设置配置时发生未指定错误。

  • Recommended Action: 在 VDA 上重新启动 Citrix Delivery Agent 服务或重新启动 VDA。

  • brk.prepare.session.failure.host_unreachable

  • Description: 与 VDA 通信失败。
  • Recommended Action: 在 VDA 上重新启动 Citrix Delivery Agent 服务或重新启动 VDA。

brk.prepare.session.failure.general

  • Description: 在 VDA 上准备会话失败，出现 UnsupportedClientType 或 ConnectionRefused 错误。

  • Recommended Action: 在 VDA 上重新启动 Citrix Delivery Agent 服务或重新启动 VDA。

  • brk.validate.ticket.failure.license

  • Description: 未能为该会话检索到有效许可证。

  • Recommended Action: 检查站点的运行状况，并确保所有连接器和 Citrix DDC 均正常运行。

  • brk.validate.ticket.failure.general

  • Description: 票证调用无效。

  • Recommended Action: 请联系 Citrix 支持。

  • brk.reverse.prepare.failure.general

  • Description: 会话启动期间发生一般性故障。

  • Recommended Action: 检查站点的运行状况，并确保所有连接器和 Citrix DDC 均正常运行。

  • brk.reverse.prepare.failure.lease_revoked

  • Description: 此会话的租约已被撤销。

  • Recommended Action: 重试操作，如果故障重复出现，请检查连接器是否处于正常运行状态。

  • brk.reverse.prepare.failure.resource_unavailable

  • Description: 资源已被占用或暂时不可用。

  • Recommended Action: 重试操作，如果故障重复出现，请检查连接器是否处于正常运行状态。

  • brk.reverse.prepare.failure.app_protection

  • Description: 缺少应用程序保护，此会话需要应用程序保护。

  • Recommended Action: 确保在此 VDA 上启用了应用程序保护，或从应用程序中删除应用程序保护要求。

  • HDX VDA Linux

VDA_LINUX_ERR_RECONNECT_PRE_LOGOFF

  • Description: 不允许重新连接到处于预注销状态的会话。
    • Recommended action: 稍后重试启动，这会给会话注销留出时间。

VDA_LINUX_ERR_RECONNECT_NO_SESSION

  • Description: 重新连接到不存在的会话。
  • Recommended action: 稍后重试启动。如果仍然失败，请联系 Citrix 支持。

VDA_LINUX_ERR_SAME_KEY

  • Description: 准备连接时，存在具有相同会话密钥的现有会话。
  • Recommended action: 请联系 Citrix 支持。

VDA_LINUX_ERR_GET_FQDN

  • Description: 未能获取此 VDA 的 FQDN。
  • Recommended action: 验证 VDA 上的 DNS 配置是否正确。

VDA_LINUX_ERR_NO_CGP_LISTENER

  • 描述: 没有 CGP 侦听器正在运行。
  • 建议操作: 验证是否已启用会话可靠性连接策略。验证 CGP 侦听器是否正在 VDA 中侦听预期端口（默认端口为 2598，可通过会话可靠性端口号策略更改）。

VDA_LINUX_ERR_DTLS_CONNECT 

-  描述: 未能与 Gateway 服务建立 DTLS 连接。
-  建议操作: 验证 VDA 是否可以访问 Gateway 服务的 FQDN。验证 VDA 中是否存在路径 `/var/xdl/keystore/cacerts`。删除 `/var/xdl/keystore` 并运行 `/var/xdl/split_ca_bundle.sh` 以重新生成 CA 证书。验证 Gateway 服务的 FQDN 是否受 VDA 信任。

VDA_LINUX_ERR_ACCEPT_EDT_CONNECT

  • 描述: 未能接受来自客户端的 EDT 握手。
  • 建议操作: 请联系 Citrix 支持。

VDA_LINUX_ERR_TCP_CONNECT 

-  描述: 未能与 Gateway 服务建立 TCP 连接。
-  建议操作: 验证 VDA 是否可以访问 Gateway 服务的 FQDN。

VDA_LINUX_ERR_TLS_CONNECT

  • 描述: 未能与 Gateway 服务建立 TLS 握手。

  • 建议操作: 验证 VDA 中是否存在路径 /var/xdl/keystore/cacerts。删除 /var/xdl/keystore 并运行 /var/xdl/split_ca_bundle.sh 以重新生成 CA 证书。验证 Gateway 服务的 FQDN 是否受信任。

  • VDA_LINUX_ERR_RDVZ_HANDSHAKE

    • 描述: 未能与 Gateway 服务建立 Rendezvous 握手。
    • 建议操作: 请联系 Citrix 支持。

VDA_LINUX_ERR_ACCEPT_ICA_CONNECT

  • 描述: 未能接受 ICA® 连接。

  • 建议操作: 请联系 Citrix 支持。

  • VDA_LINUX_ERR_RECONNECT_TO_ANON_SESSION_NOT_ALLOWED

  • 描述: 不允许重新连接到匿名会话。
    • 建议操作: 请联系 Citrix 支持。

VDA_LINUX_ERR_CONN_NOT_ALLOWED 

-  描述: 不允许连接。
-  建议操作: 如果结果代码为 3，请验证许可证是否未过期，否则请稍后重试启动。如果无法解决，请联系 Citrix 支持。

  • VDA_LINUX_ERR_CONN_GENERAL

  • 描述: 未能验证连接。

  • 建议操作: 请联系 Citrix 支持。

  • VDA_LINUX_ERR_USER_CANCELLED_LOGIN

  • 描述: 最终用户取消了登录。
  • 建议操作: 当 SSO 被禁用且最终用户单击登录框中的“取消”按钮时，此错误是预期行为；否则，请联系 Citrix 支持。

VDA_LINUX_ERR_GET_TARGET

  • 描述: 未能获取目标会话。

  • 建议操作: 请联系 Citrix 支持。

  • VDA_LINUX_ERR_START_LOGON_TIMERS

  • 描述: 未能启动登录计时器。

  • 建议操作: 请联系 Citrix 支持。

  • VDA_LINUX_ERR_SEND_CMD_TO_TARGET

    • 描述: 未能将命令发送到目标会话。
    • 建议操作: 请联系 Citrix 支持。

VDA_LINUX_ERR_POST_RECONNECT_EVENT

  • 描述: 未能发布重新连接事件。

  • 建议操作: 请联系 Citrix 支持。

  • VDA_LINUX_ERR_RECONNECT_TIMEOUT

  • 描述: 重新连接用户会话超时。

  • 建议操作: 请联系 Citrix 支持。

  • HDX VDA Windows

RENDEZVOUS_CONNECT_FAILED_TCP 

-  描述: 从 VDA 到 Citrix Gateway Rendezvous 点的 TCP 出站 Rendezvous 连接尝试失败。
-  建议操作:

-  在 VDA 上检查 Rendezvous 和 UDP/DTLS 网络配置。
-  如果上述所有内容都合适，请提交支持工单。（如果可能）共享来自 VDA 的 AO 和 CDF 跟踪以及来自网关/VDA 的网络数据包捕获。

  • RENDEZVOUS_CONNECT_FAILED_EDT

  • 描述: 从 VDA 到 Citrix Gateway Rendezvous 点的 EDT 出站 Rendezvous 连接尝试失败。

  • 建议操作:

    • 在 VDA 和 CGS 上检查 Rendezvous 和 UDP/DTLS 网络配置。
    • 如果上述所有内容都合适，请提交支持工单。（如果可能）共享来自 VDA 的 AO 和 CDF 跟踪以及来自网关/VDA 的网络数据包捕获。

  • RENDEZVOUS_CONNECT_FAILED_PROXY

  • 描述: 从 VDA 到 Citrix Gateway Rendezvous 点的通过代理的出站 Rendezvous 连接尝试失败。

  • 建议操作:

    • 查阅 Citrix 文档，检查 Rendezvous 代理配置。
    • 如果上述所有内容都合适，请提交支持工单。（如果可能）共享来自 VDA 的 AO 和 CDF 跟踪以及来自网关/VDA 的网络数据包捕获。

  • RENDEZVOUS_CONNECT_FAILED_DTLS

  • 描述: 从 VDA 到 Citrix Gateway Rendezvous 点的出站 Rendezvous 连接尝试因 DTLS 握手失败而失败。

  • 建议操作:

    • 在 VDA 上检查 Rendezvous 和 UDP/DTLS 网络配置。
    • 根据 Citrix 文档检查 Rendezvous 和加密要求。
    • 如果上述所有内容都合适，请提交支持工单。（如果可能）共享来自 VDA 的 AO 和 CDF 跟踪以及来自网关/VDA 的网络数据包捕获。

  • RENDEZVOUS_CONNECT_FAILED_TLS

  • 描述: 从 VDA 到 Citrix Gateway Rendezvous 点的出站 Rendezvous 连接尝试因 TLS 握手失败而失败。

  • 建议操作:

    • 在 VDA 上检查 Rendezvous 和 TCP/DTLS 网络配置。
    • 根据 Citrix 文档检查 Rendezvous 和加密要求。
    • 如果上述所有内容都合适，请提交支持工单。（如果可能）共享来自 VDA 的 AO 和 CDF 跟踪以及来自网关/VDA 的网络数据包捕获。

RENDEZVOUS_CONNECT_FAILED_CGP

  • 描述：由于 CGP 配置问题，出站 Rendezvous 传输连接尝试失败。

  • 建议操作：检查 CGP（会话可靠性）是否已启用且 CGP 端口正在侦听，然后联系 Citrix 支持。

  • CGP_SR_SUSPEND_RESUME_FAILED_TIMEOUT

  • 描述：当 ICA 会话遇到网络中断导致数据包流中断时，VDA 会进入会话可靠性 (SR) 模式。如果此网络问题未在指定时间内（默认设置为 180 秒，请参阅 Citrix 策略文档）解决，则可能会发生超时，由 CGP_SR_SUSPEND_RESUME_FAILED_TIMEOUT 事件指示。

  • 建议操作：

    • 如果 ICA 会话未在超时期限内重新连接，最终用户可以在客户端上检查网络连接，例如 Windows 任务栏上的网络和 Internet 设置。
    • 当 ICA 会话处于会话可靠性模式时，尝试在客户端的 Web 浏览器中打开 Internet 资源，以确保 Internet 访问按预期工作。
    • 如果网站加载但 ICA 会话无法重新连接，则需要进一步调试。请提交支持工单，并附上 AO 日志以及 VDA 和客户端的 CDF 跟踪（如果可能）。

  • CGP_SR_SUSPEND_RESUME_FAILED

  • 描述：当 ICA 会话遇到网络中断导致数据包流中断时，VDA 会进入会话可靠性 (SR) 模式。CGP_SR_SUSPEND_RESUME_FAILED 事件表示处理挂起或恢复请求时发生故障，而不是超时。

  • 建议操作：提交支持工单，并附上 AO 日志以及 CDF 跟踪（如果可能），网络拓扑（尤其是分支中继器的使用情况）。

  • PREPARE_RECONNECT_REJECTED

  • 描述：VDA 因会话密钥无效而拒绝了来自传入 ICA 连接的重新连接请求。

  • 建议操作：

    • 检查 VDA 上的事件日志，查找侦听器创建错误。
    • 或者检查侦听器是否处于活动状态。在 RDS 计算机上，’netstat -a’ 可以列出端口和相应的拥有者。检查是否有任何应用程序已在使用为 ICA 指定的端口。
    • 提交支持工单给 Citrix，并附上 AO 日志以及客户端和 VDA 上所有模块的 CDF 跟踪（如果可能）。

错误：PREPARE_REJECTED

  • 描述：VDA 因会话密钥无效而拒绝了来自传入 ICA 连接的连接请求。

  • 建议操作：检查 VDA 配置，联系 Citrix 支持。

  • PREPARE_LISTENING_FAILED

  • 描述：VDA 未能为传入的 ICA 连接启动侦听器。

  • 建议操作：检查网络配置，验证侦听器端口未被其他应用程序使用，联系 Citrix 支持。

  • RENDEZVOUSCONNECTIONREQ_FAILED

  • 描述：VDA 未能通知 ICA 堆栈启动出站 Rendezvous 连接。
  • 建议操作：检查 Rendezvous 配置，检查 Rendezvous 代理配置，检查 CGP（会话可靠性）配置，联系 Citrix 支持。

RENDEZVOUSCONNECTIONREQ_FAILED_PROXYCONFIG

  • 描述：VDA 因代理配置错误而未能请求 ICA 堆栈启动出站 Rendezvous 连接。

  • 建议操作：检查 Rendezvous 代理配置，联系 Citrix 支持。

  • ESTABLISH_SESSION_FAILED

  • 描述：VDA 未能为传入的 ICA 连接创建会话或未能连接到现有会话。

  • 建议操作：提交支持工单，并附上 AO 日志以及客户端和 VDA 上所有模块的 CDF 跟踪（如果可能）。

  • ICA_ESTABLISH_FAILED

  • 描述：已收到传输连接，但在握手期间连接建立失败。

  • 建议操作：

    • 检查端口扫描软件，这些软件会扫描 1494、2598 等 ICA 端口，这些端口可能始终启用侦听器以接收任何连接请求，因此可能会将这些消息作为失败尝试吐出。或者在 Splunk 中过滤掉不需要 ICA 会话预启动序列的错误。
    • 提交支持工单，并附上 AO 日志以及 CDF 跟踪（如果可能），以及 VDA 和客户端的 Wireshark 捕获（如果可能），以解决其他故障。

VALIDATE_FAILED

  • 描述：Broker 未能验证来自 VDA 的传入 ICA 连接请求。

  • 建议操作：提交支持工单，并附上 AO 日志以及客户端和 VDA 上所有模块的 CDF 跟踪（如果可能）。

  • VALIDATE_TICKETING_FAILED

  • 描述：Broker 因票证问题未能验证来自 VDA 的传入 ICA 连接请求。

  • 建议操作：提交支持工单，并附上 AO 日志以及客户端和 VDA 上所有模块的 CDF 跟踪（如果可能）。

  • PREPARE_FAILED

  • 描述：通常表示 VDA 上传入 ICA 会话的准备工作因某些错误而失败。

  • 建议操作：

    • 在 Citrix Studio 中检查会话状态，确认会话已注销且未滞留。
    • 检查侦听器是否已启动。检查 VDA 上的事件查看器，查找侦听器创建错误。
    • 提交支持工单给 Citrix，并附上 AO 日志以及客户端和 VDA 上所有模块的 CDF 跟踪（如果可能）。

  • MCS

brk.poweron.forlaunch.execution.generalfailure

  • 描述：一般错误。

  • 建议操作：联系 Citrix 支持。

  • brk.poweron.forlaunch.execution.insufficientresourcefailure

  • 描述：由于管理程序上的资源不足，无法完成管理程序操作。

  • 建议操作：检查管理程序中的资源配额。如果找不到解决方案，请联系 Citrix 支持。

  • brk.poweron.forlaunch.execution.nosuchmanagedmachine

  • 描述：计算机 ID 不存在。
  • 建议操作：检查管理程序中的计算机 ID。如果找不到解决方案，请联系 Citrix 支持。

brk.poweron.forlaunch.execution.hypervisorconnectionfailure

  • 描述：无法建立与管理程序的连接。例如，未找到托管基础结构地址。

  • 建议操作：验证托管基础结构地址是否正确。如果找不到解决方案，请联系 Citrix 支持。

  • brk.poweron.forlaunch.execution.invalidcredentialsfailure

  • 描述：无效凭据。

  • 建议操作：检查管理程序连接的凭据。如果找不到解决方案，请联系 Citrix 支持。

  • brk.poweron.forlaunch.execution.authorizationfailure

  • 描述：权限或凭据不足。
  • 建议操作：检查分配给管理程序连接凭据的权限。如果找不到解决方案，请联系 Citrix 支持。

brk.poweron.forlaunch.execution.sslcertauthfailure

  • 描述：由于 SSL 身份验证问题，无法建立连接。

  • 建议操作：检查管理程序的连接证书。如果找不到解决方案，请联系 Citrix 支持。

  • brk.poweron.forlaunch.execution.ratelimitedfailure

  • 描述：云连接报告它正在进行速率限制。
  • 建议操作：如果请求被管理程序的速率限制阻止，请稍后重试连接。如果找不到解决方案，请联系 Citrix 支持。

brk.poweron.forlaunch.execution.connectorconnectionfailure

  • Description: 云连接器上存在错误。例如，等待连接时发生超时。达到超时后，云连接器将断开连接。

  • Recommended action: 重启云连接器。如果失败，请联系 Citrix 支持。

  • brk.poweron.forlaunch.execution.remotehclserverconnectionfailure

  • Description: 设置与插件的连接时，HCL/远程代理插件或端点上出现错误或未找到端点。

  • Recommended action: 重启连接器。如果失败，请联系 Citrix 支持。

  • brk.poweron.forlaunch.execution.expiredcredentialsfailure

  • Description: 提供了过期的凭据。
  • Recommended action: 刷新虚拟机管理程序连接使用的过期凭据。

brk.poweron.forlaunch.execution.mcsmachinemanagementcustomfailure

  • Description: 计算机创建期间出错。

  • Recommended action: 联系 Citrix 支持。

  • brk.poweron.forlaunch.execution.detachdiskfailed

  • Description: 虚拟机使用的分离磁盘失败。
  • Recommended action: 联系 Citrix 支持。

brk.poweron.forlaunch.execution.createclonefailed

  • Description: 在虚拟机管理程序中创建克隆磁盘失败。

  • Recommended action: 联系 Citrix 支持。

  • brk.poweron.forlaunch.execution.provisionedvmnotfound

  • Description: 未找到预配的 VM。

  • Recommended action: 从目录中移除预配的 VM。如果失败，请联系 Citrix 支持。

  • brk.poweron.forlaunch.execution.invalidvmstate

  • Description: 由于 VM 状态无效，操作无法继续。
  • Recommended action: 首先重启 VM，然后重试该操作。

brk.poweron.forlaunch.execution.insufficientresources

  • Description: 操作期间资源不足。

  • Recommended action: 检查虚拟机管理程序使用的资源配额。

  • brk.poweron.forlaunch.execution.hypervisorinmaintenancemode

  • Description: 由于虚拟机管理程序处于维护模式，操作无法继续。

  • Recommended action: 验证虚拟机管理程序是否处于维护模式。

  • brk.poweron.forlaunch.execution.delayed

  • Description: 操作已排队。
  • Recommended action: 等待进程完成。如果操作失败，请联系 Citrix 支持。

brk.poweron.forlaunch.execution.recreatevmfailed

  • Description: VM 的重新创建失败。

  • Recommended action: 联系 Citrix 支持。

  • brk.poweron.forlaunch.execution.unknownvirtualmachine

  • Description: 未知的虚拟机。
  • Recommended action: 联系 Citrix 支持。

brk.poweron.forlaunch.execution.ratelimitexceed

  • Description: 云连接正在进行速率限制。

  • Recommended action: 如果请求被虚拟机管理程序的速率限制阻止，请稍后重试连接。

  • brk.poweron.forlaunch.execution.virtualdisknotyetonstorage

  • Description: 虚拟磁盘未存储。

  • Recommended action: 稍后重试。如果失败，请联系 Citrix 支持。

  • 配置文件管理

xendesktop.upm.userprofile.error.failure

  • Description: Citrix Profile Management 未能处理用户配置文件。改用临时配置文件。

  • Recommended action: 此错误不会导致登录失败。Citrix Profile Management 改用临时配置文件。要解决此错误，请检查 Windows 事件日志。

  • xendesktop.upm.userprofile.error.timeout

  • Description: Citrix Profile Management 未能在指定时间内处理用户配置文件。

  • Recommended action: 此错误不会导致登录失败。Citrix Profile Management 继续处理用户配置文件。要解决此错误，请检查 Citrix Profile Management 日志。

  • WEM 代理

wem.agent.userpolicy.error.failure

  • Description: Workspace Environment Management™ (WEM) 代理未能处理用户的组策略。用户登录继续。

  • Recommended action: 此错误不会导致登录失败。有关更多详细信息，请参阅 WEM 产品文档并检查 WEM 代理服务日志。

  • wem.agent.userpolicy.error.timeout

  • Description: Workspace Environment Management (WEM) 代理未能在指定时间内处理用户的组策略。用户登录继续。
  • Recommended action: 此错误不会导致登录失败。有关更多详细信息，请参阅 WEM 产品文档并检查 WEM 代理服务日志。

Android 启动后

  • SessionManager.Launch.EngineLoadFailed

  • Description: 未能加载或初始化 ICA Engine。

  • Recommended Action: 联系 Citrix 支持。

  • SessionManager.Launch.ConnectionFailed

  • Description: 引擎在连接前终止。
  • Recommended Action: 联系 Citrix 支持。

SessionManager.Launch.LogonFailed

  • Description: 会话断开连接，未完成登录。

  • Recommended action: 联系 Citrix 支持。

  • SessionManager.LeaseResolution.Failed

  • 描述：无法尝试租约启动。

  • 建议操作：请联系 Citrix 支持。

  • SessionManager.clxmtp.SoftDeny

  • 描述：引擎 CLXMTP 协商失败（软拒绝）。
  • 建议操作：请联系 Citrix 支持。

SessionManager.clxmtp.SoftDeny_Implicit

  • 描述：引擎 CLXMTP 连接失败（隐式软拒绝）。

  • 建议操作：请联系 Citrix 支持。

  • Transport.Connect.NoCGP_Fail

  • 描述：连接失败（CGP 已禁用）。
  • 建议操作：请联系 Citrix 支持。

Transport.Connect.FallbackFail

  • 描述：连接失败。已尝试 ICA 回退。

  • 建议操作：请联系 Citrix 支持。

  • Transport.Connect.Fail

  • 描述：连接不可用。

  • 建议操作：请联系 Citrix 支持。

  • Android 预启动

CWA-ICADOWNLOAD_ERR_00001

  • 描述：发送的 ICA 请求类型不正确。

  • 建议操作：请联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00002

  • 描述：ICA 请求无效。

  • 建议操作：请联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00003

  • 描述：ICA 请求的 Store 为空。
  • 建议操作：请联系 Citrix 支持。

CWA-ICADOWNLOAD_ERR_00004

  • 描述：ICA 请求的 Store URL 为空。

  • 建议操作：请联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00005

  • 描述：ICA 请求的资源参数为空。
  • 建议操作：请联系 Citrix 支持。

CWA-ICADOWNLOAD_ERR_00006

  • 描述：为 ICA 请求提供的资源参数不是有效的资源类型。

  • 建议操作：请联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00007

  • 描述：为 ICA 请求提供的资源参数对于 ICA 启动 URL 为空。

  • 建议操作：请联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00008

  • 描述：ICA 请求为空，并带有身份验证管理器参数。
  • 建议操作：请联系 Citrix 支持。

CWA-ICADOWNLOAD_ERR_00009

  • 描述：ICA 请求正文为空。

  • 建议操作：请联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00010

  • 描述：未能从 ICA 请求正文创建 HTTP 实体。
  • 建议操作：请联系 Citrix 支持。

CWA-ICADOWNLOAD_ERR_00011

  • 描述：由于创建身份验证管理器请求时出现异常，未能下载 ICA 文件。

  • 建议操作：请联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00012

  • 描述：由于运行身份验证管理器请求时出现异常，未能下载 ICA 文件。

  • 建议操作：请联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00013

  • 描述：由于身份验证管理器请求的响应异常，未能下载 ICA 文件。
  • 建议操作：请联系 Citrix 支持。

CWA-ICADOWNLOAD_ERR_00014

  • 描述：从身份验证管理器响应复制输入流时，未能下载 ICA 文件。

  • 建议操作：请联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00015

  • 描述：使用身份验证管理器响应中的输入流解析 ICA 文档失败。

  • 建议操作：请联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00016

  • 描述：下载的 ICA 文档为空，且未出现任何异常。
  • 建议操作：请联系 Citrix 支持。

CWA-ICADOWNLOAD_ERR_00017

  • 描述：由于响应不成功，未能下载 ICA 文件。

  • 建议操作：请联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00018

  • 描述：资源不可用。

  • 建议操作：联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00019

  • 描述：要启动的资源不存在、未启用或用户不可见。
  • 建议操作：联系 Citrix 支持。

CWA-ICADOWNLOAD_ERR_00020

  • 描述：没有更多活动会话。

  • 建议操作：联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00021

  • 描述：服务器没有执行请求活动所需的许可证。

  • 建议操作：联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00022

  • 描述：没有可用的工作站。
  • 建议操作：联系 Citrix 支持。

CWA-ICADOWNLOAD_ERR_00023

  • 描述：无法连接到工作站。服务器已拒绝连接。

  • 建议操作：联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00024

  • 描述：工作站正在维护中，无法使用。

  • 建议操作：联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00025

  • 描述：无法启动资源，因为 ICA 文件中存在 resourceerror 错误。
  • 建议操作：联系 Citrix 支持。

CWA-ICADOWNLOAD_ERR_00026

  • 描述：无法启动资源，因为 ICA 文件中存在 generalapplauncherror 错误。

  • 建议操作：联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00027

  • 描述：无法启动资源，因为 ICA 文件中存在未知错误。

  • 建议操作：联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00028

  • 描述：无法启动资源，因为 ICA 文件中存在重启错误。
  • 建议操作：联系 Citrix 支持。

CWA-ICADOWNLOAD_ERR_00029

  • 描述：无法启动资源，因为 ICA 文件中存在恢复错误。

  • 建议操作：联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00030

  • 描述：无法启动资源，因为 ICA 文件中存在未定义错误。

  • 建议操作：联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00031

  • 描述：无法下载 ICA 文件。但是，在定义的映射中找不到错误代码。
  • 建议操作：联系 Citrix 支持。

Linux 启动后

  • SessionManager.Launch.EngineLoadFailed

  • 描述：加载 ICA 引擎失败。

  • 建议操作：联系 Citrix 支持。

  • SessionManager.Launch.Failed

  • 描述：启动会话失败。
  • 建议操作：联系 Citrix 支持。

SessionManager.Launch.ConnectionFailed

  • 描述：引擎在连接前终止。

  • 建议操作：查找与启动尝试相关的其他错误。

  • SessionManager.Launch.LogonFailed

  • 描述：会话在未完成登录的情况下断开连接。

  • 建议操作：此错误表示登录失败，可能包括用户未能手动输入凭据。调查用户尝试登录远程 VDA 的方式。

  • SessionManager.LeaseResolution.Failed

  • 描述：无法尝试租约启动。
  • 建议操作：验证租约是否已同步到客户端计算机并仍然有效。用户可以在联机模式下登录 Citrix Workspace 以触发租约的（重新）同步。查找 Gateway 或 Cloud Connector 组件发送的错误。这些错误可能指示失败的原因。

Transport.Connect.NoCGP_Fail

  • 描述：连接失败（CGP 已禁用）。

  • 建议操作：调查客户端无法通过 TCP 或 EDT 联系 VDA 的原因。

  • Transport.Connect.FallbackFail

  • 描述：连接失败。尝试了 ICA 回退。

  • 建议操作：调查客户端无法通过 TCP 或 EDT 联系 Gateway、Connector 或 VDA 的原因。

  • Transport.Connect.Fail

  • 描述：Citrix Workspace 应用程序无法通过 TCP、EDT 或 UDP 连接到 Gateway、Connector 或 VDA。
  • 建议操作：调查客户端无法通过 TCP、EDT 或 UDP 联系 Gateway、Connector 或 VDA 的原因。客户端和主机之间的防火墙可能不允许这些协议 (UDP/TCP) 或所需的端口。

SessionManager.clxmtp.SoftDeny

  • 描述：引擎 CLXMTP 协商失败（软拒绝）。

  • 建议操作：此错误并不表示启动一定会失败。它表示引擎无法通过特定的网络路径成功。查找 Gateway 或 Cloud Connector 组件发送的错误。这些错误可能指示失败的原因。

  • SessionManager.clxmtp.SoftDeny_Implicit

  • Description: 引擎 CLXMTP 连接失败（隐式软拒绝）。
  • Recommended Action: 此错误不表示启动必须失败。它表示引擎无法通过特定的网络路径成功连接。请调查客户端无法联系连接器或网关的原因。由于网络拓扑或防火墙限制，该主机可能无法访问，这可能是预期情况。

Linux 预启动

  • CWA-ICADOWNLOAD_ERR_00001

  • Description: 由于 Citrix Workspace 应用程序无响应，无法连接到应用商店。

  • Recommended action: 验证 Citrix Workspace 或 StoreFront 是否已关闭。同时，验证互联网连接。

  • CWA-ICADOWNLOAD_ERR_00002

  • Description: 用户已取消会话启动。
  • Recommended action: 请稍后重新启动会话。

CWA-ICADOWNLOAD_ERR_00003

  • Description: 无法连接到应用商店。请验证服务器证书是否有效。

  • Recommended action: 验证服务器证书是否已安装并处于活动状态。

  • CWA-ICADOWNLOAD_ERR_00004

  • Description: 要启动的资源不存在、未启用或对用户不可见。

  • Recommended action: 请联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00005

  • Description: 工作站不适用于此请求。
  • Recommended action: 请联系 Citrix 支持。

CWA-ICADOWNLOAD_ERR_00006

  • Description: 服务器没有执行所请求活动所需的许可证。

  • Recommended action: 请联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00007

  • Description: 服务器拒绝连接到工作站。

  • Recommended action: 请联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00008

  • Description: 所请求的工作站正在维护中，无法使用。
  • Recommended action: 请联系 Citrix 支持。

CWA-ICADOWNLOAD_ERR_00009

  • Description: 已达到最大会话限制。

  • Recommended action: 已达到管理员配置的最大会话限制。请重新启动会话。

  • CWA-ICADOWNLOAD_ERR_000010

  • Description: 无法进一步指定的常规错误。

  • Recommended action: 请联系 Citrix 支持。

  • Mac 启动后

桌面启动失败

  • Description: “Desktop name” 桌面启动失败。事务 ID - “Transaction ID”。

  • Recommended action: 请联系您的管理员并提供错误详细信息。

  • 查看器启动失败

  • Description: 查看器启动失败。事务 ID - “Transaction ID”。

  • Recommended action: 请联系您的管理员并提供错误详细信息。

  • 桌面启动失败

  • Description: “Desktop name” 桌面正在计划维护中。事务 ID - “Transaction ID”。
  • Recommended action: 请联系您的管理员并提供错误详细信息。

应用程序启动失败

  • Description: “App name” 启动失败。

  • Recommended action: 请联系您的管理员并提供错误详细信息。

  • 应用程序启动失败

  • Description: “App name” 启动失败。事务 ID - “Transaction ID”。

  • Recommended action: 请联系您的管理员并提供错误详细信息。

  • 桌面启动失败

  • Description: “Desktop name” 桌面启动失败。
  • Recommended action: 请联系您的管理员并提供错误详细信息。

桌面启动失败

  • Description: “Desktop name” 桌面启动失败。事务 ID - “Transaction ID”。

  • Recommended action: 请联系您的管理员并提供错误详细信息。

  • 查看器启动失败

  • Description: 查看器未能打开“Application name”。事务 ID - “Transaction ID”。
  • Recommended action: 请联系您的管理员并提供错误详细信息。

查看器启动失败

  • Description: 查看器未能打开桌面“Desktop name”。事务 ID - “Transaction ID”。

  • Recommended action: 请联系您的管理员并提供错误详细信息。

  • 桌面启动失败

  • Description: “Desktop name” 桌面正在计划维护中。

  • Recommended action: 请联系您的管理员并提供错误详细信息。

  • 桌面启动失败

  • Description: “Desktop name” 桌面正在计划维护中。事务 ID - “Transaction ID”。
  • Recommended action: 请联系您的管理员并提供错误详细信息。

无法连接到桌面

  • 描述：无法访问“desktop name”桌面。事务 ID - “Transaction ID”。请稍后重试。

  • 建议操作：如果问题仍然存在，请联系管理员并提供错误详细信息。

  • Mac 预启动

  • CWA-ICADOWNLOAD_ERR_00001

  • 描述：ICA 文件无效。
  • 建议操作：请联系 Citrix 支持。

CWA-ICADOWNLOAD_ERR_00002

  • 描述：启动请求已超时。
  • 建议操作：请验证互联网连接或联系 Citrix 支持。

CWA-ICADOWNLOAD_ERR_00003

  • 描述：服务器未响应。
  • 建议操作：请联系 Citrix 支持。

CWA-ICADOWNLOAD_ERR_00004

  • 描述：要启动的资源不存在、未启用或对用户不可见。
  • 建议操作：请联系 Citrix 支持。

CWA-ICADOWNLOAD_ERR_00005

  • 描述：服务器无法访问。

  • 建议操作：请联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00006

  • 描述：启动查看器时出错。

  • 建议操作：请联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00007

  • 描述：无法启动 Apple 打开事件。
  • 建议操作：请联系 Citrix 支持。

CWA-ICADOWNLOAD_ERR_00008

  • 描述：查看器路径无法访问。

  • 建议操作：请联系 Citrix 支持。

  • CWA-ICADOWNLOAD_ERR_00009

  • 描述：用户取消了身份验证。

  • 建议操作：请用户重新启动资源。

  • CWA-ICADOWNLOAD_ERR_000010

  • 描述：用户取消了 LSI 窗口。
  • 建议操作：请用户重新启动资源。

CWA-ICADOWNLOAD_ERR_000011

  • 描述：请求的工作站正在维护中，不可用。
  • 建议操作：请用户在维护完成后且工作站可用时重试。

CWA-ICADOWNLOAD_ERR_000012

  • 描述：用户登录凭据必须更改。
  • 建议操作：请用户更改登录凭据。

CWA-ICADOWNLOAD_ERR_000013

  • 描述：连接资源的会话不再处于活动状态。
  • 建议操作：请用户重试，或联系 Citrix 技术支持以获得进一步帮助。

CWA-ICADOWNLOAD_ERR_000014

  • 描述：无法下载 ICA 文件。
  • 建议操作：请联系 Citrix 支持。

Windows 启动后

SessionManager.Launch.EngineLoadFailed

  • 描述：用于建立与远程桌面或应用程序连接的核心组件未能正确加载或初始化。错误消息中可能会提供更多详细信息。
  • 建议操作：Citrix Workspace 应用程序未按预期运行。第三方（非 Citrix）虚拟通道 DLL 或其他系统组件可能导致此问题。可能需要收集并提交 CDF 跟踪以确定故障性质。

SessionManager.Launch.ConnectionFailed

  • 描述：此错误是通用故障，表明启动尝试失败。发送的其他错误可能指示原因。
  • 建议操作：请查找与启动尝试相关的其他错误。

SessionManager.Launch.LogonFailed

  • 描述：此错误表明已建立与远程桌面或应用程序的连接。但是，会话在未完成 Windows（或其他操作系统）登录的情况下断开连接。
  • 建议操作：此错误指示某些登录失败，可能包括用户未能手动输入凭据。请调查用户如何尝试登录远程 VDA。

SessionManager.Launch.Cancelled

  • 描述：Citrix 引擎的连接尝试已取消，很可能是由用户操作引起的。
  • 建议操作：此错误指示连接未能成功建立的原因，但可能指示了正确的行为。

SessionManager.LeaseResolution.Failed

  • 描述：指示脱机（也称为“基于租约”）启动失败。此失败是因为在客户端计算机上未找到资源的有效且必需的租约。此外，网关或云连接器拒绝了启动请求，或者启动请求以某种方式无效。
  • 建议操作：请验证租约是否已同步到客户端计算机，并且仍然有效。用户可以在联机模式下登录 Citrix Workspace 以触发租约的（重新）同步。请查找网关或云连接器组件发送的错误。这些错误可能指示失败的原因。

SessionManager.clxmtp.SoftDeny

  • 描述：尝试了租约启动，并且连接器或网关通知客户端无法完成请求的启动。但是，其他连接器或网关可能能够帮助启动。
  • 建议操作：此错误并不表示启动一定会失败。它表示引擎无法通过特定网络路径成功。请查找网关或云连接器组件发送的错误。这些错误可能指示失败的原因。

SessionManager.clxmtp.SoftDeny_Implicit

  • 描述：尝试了租约启动，并且连接器或网关无法访问。但是，其他连接器或网关可能能够帮助启动。
  • 建议操作：此错误并不表示启动一定会失败。它表示引擎无法通过特定网络路径成功。请调查客户端为何无法联系连接器或网关。由于网络拓扑或防火墙限制，该主机可能无法访问，这可能是预期情况。

Transport.Connect.NoCGP_Fail

  • 描述：Citrix Workspace 应用程序核心（引擎）组件未能通过 ICA 协议（端口 1494）连接到 VDA 主机。如果发送此事件，则未尝试通过 CGP 协议连接到网关或 VDA。
  • 建议操作：请调查客户端为何无法通过 TCP 或 EDT 联系 VDA。

Transport.Connect.FallbackFail

  • Description: Citrix Workspace 应用程序核心（引擎）组件未能通过 ICA 协议（端口 1494）连接到 VDA 主机。在此故障之后，Citrix Workspace 应用程序未能通过 CGP 协议（端口 2598）连接到 Gateway 或 VDA。
  • Recommended action: 调查客户端为何无法通过 TCP 或 EDT 连接到 Gateway、Connector 或 VDA。

Transport.Connect.Fail

  • Description: Citrix Workspace 应用程序核心（引擎）组件未能通过 CGP 协议（端口 2598）连接到 Gateway 或 VDA。如果发出此事件，则未尝试通过 ICA 协议连接到 VDA。
  • Recommended action: 调查客户端为何无法通过 TCP 或 EDT 连接到 Gateway、Connector 或 VDA。

Windows 预启动

CWA-ICADOWNLOAD_ERR_00001

  • Description: 由于 Citrix Workspace 应用程序无响应，无法连接到应用商店。
  • Recommended action: 验证 Citrix Workspace 或 StoreFront 是否已关闭。另外，验证 Internet 连接。

CWA-ICADOWNLOAD_ERR_00002

  • Description: 用户已取消会话启动。
  • Recommended action: 稍后重新启动会话。

CWA-ICADOWNLOAD_ERR_00003

  • Description: 无法连接到应用商店。验证服务器证书是否有效。
  • Recommended action: 请联系您的 IT 管理员并提供错误详细信息。

CWA-ICADOWNLOAD_ERR_00004

  • Description: 要启动的资源不存在、未启用或对用户不可见。
  • Recommended action: 请联系您的 IT 管理员并提供错误详细信息。

CWA-ICADOWNLOAD_ERR_00005

  • Description: 工作站不适用于此请求。
  • Recommended action: 请联系您的 IT 管理员并提供错误详细信息。

CWA-ICADOWNLOAD_ERR_00006

  • Description: 服务器没有执行所请求活动所需的许可证。
  • Recommended action: 请联系您的 IT 管理员并提供错误详细信息。

CWA-ICADOWNLOAD_ERR_00007

  • Description: 服务器已拒绝连接到工作站。
  • Recommended action: 请联系您的 IT 管理员并提供错误详细信息。

CWA-ICADOWNLOAD_ERR_00008

  • Description: 所请求的工作站正在维护中，无法使用。
  • Recommended action: 请联系您的 IT 管理员并提供错误详细信息。

CWA-ICADOWNLOAD_ERR_00009

  • Description: 已达到最大会话限制。
  • Recommended action: 已达到管理员配置的最大会话限制。重新启动会话。

CWA-ICADOWNLOAD_ERR_000010

  • Description: 无法进一步指定的常规错误。
  • Recommended action: 请联系您的 IT 管理员并提供错误详细信息。

工作区

StoreLaunchIcaEndpoint.LaunchFailed

  • Description: 启动时发生错误。
  • Recommended action: 验证您的 Citrix Virtual Apps and Desktops 日志。请联系 Citrix 支持。

StoreLaunchSessionEndpoint.BadRequest

  • Description: 启动请求的参数无效或为空。
  • Recommended action: 请联系 Citrix 支持。

StoreLaunchSessionEndpoint.FarmUnavailable

  • Description: 没有可用于启动的场。
  • Recommended action: 验证您的 Citrix Virtual Apps and Desktops 日志。

StoreLaunchSessionEndpoint.Error

  • Description: 启动时发生内部错误。
  • Recommended action: 请联系 Citrix 支持。

StoreGetIcaFileEndpoint.BadRequest

  • Description: 请求中未提供启动票证。
  • Recommended action: 请联系 Citrix 支持。

StoreGetIcaFileEndpoint.RetrieveIcaFileForTicketFailed

  • Description: 工作区无法检索 ICA 文件。
  • Recommended action: 请联系 Citrix 支持。

StoreGetIcaFileEndpoint.Error

  • Description: 工作区无法检索 ICA 文件。
  • Recommended action: 请联系 Citrix 支持。

WebProxyGetLaunchStatusEndPoint.DSAuthFailure

  • Description: 存在身份验证问题。
  • Recommended action: 尝试重新进行身份验证。请联系 Citrix 支持。

WebProxyGetLaunchStatusEndPoint.LaunchFailed

  • Description: 启动应用程序时发生内部错误。
    • Recommended action: 请联系 Citrix 支持。

WebProxyGetLaunchStatusEndPoint.ResourceNotFound 

-  Description: 启动失败，因为找不到应用程序。
-  Recommended action: 验证您的 Citrix Virtual Apps and Desktops 日志和应用程序配置。

WebProxyLaunchIcaEndpoint.DSAuthFailure

  • Description: 存在身份验证问题。
  • Recommended action: 尝试重新进行身份验证。联系 Citrix 支持。

WebProxyLaunchIcaEndpoint.LaunchFailed 

-  Description: 启动应用程序时发生内部错误。
-  Recommended action: 联系 Citrix 支持。

WebProxyLaunchIcaEndpoint.ResourceNotFound 

-  Description: 启动失败，因为找不到应用程序。
  • Recommended action: 验证您的 Citrix Virtual Apps and Desktops 日志和应用程序配置。

WebProxySessionsLaunchIcaEndpoint.SessionNotFound

  • Description: Workspace 无法重新连接到现有 HDX 会话。您的会话可能已终止。
    • Recommended action: 重新启动应用程序。

WebProxySessionsLaunchIcaEndpoint.DSAuthFailure 

-  Description: 存在身份验证问题。
-  Recommended action: 尝试重新进行身份验证。联系 Citrix 支持。

WebProxySessionsLaunchIcaEndpoint.ReconnectSessionFailed

  • Description: Workspace 无法重新连接到现有 HDX 会话。您的会话可能已终止。
  • Recommended action: 联系 Citrix 支持。

WebProxySessionsLaunchIcaEndpoint.Error

  • Description: 重新连接到会话时发生内部错误。
  • Recommended action: 联系 Citrix 支持。

WebProxySessionsGetLaunchStatusEndpoint.DSAuthFailure

  • Description: 存在身份验证问题。
  • Recommended action: 尝试重新进行身份验证。联系 Citrix 支持。

WebProxySessionsGetLaunchStatusEndpoint.ReconnectSessionFailed 

-  Description: Workspace 无法重新连接到 HDX 会话。
-  Recommended action: 联系 Citrix 支持。

WebProxySessionsGetLaunchStatusEndpoint.Error 

-  Description: 重新连接到会话时发生内部错误。
  • Recommended action: 联系 Citrix 支持。

DetermineGateway.Error

  • Description: Workspace 无法确定要连接到哪个 Gateway。
    • Recommended action: 验证您的 Gateway 配置。联系 Citrix 支持。

ConnectionRoutingProviderLaunch.Error 

-  Description: Workspace 无法确定要连接到哪个 Gateway。
-  Recommended action: 验证您的 Gateway 配置。联系 Citrix 支持。

BrokerGetAddressCall.AnonymousPrelaunchNotSupported

  • Description: Workspace 无法启动应用程序，因为场不支持匿名启动。
  • Recommended action: 联系 Citrix 支持。

BrokerGetAddressCall.LeasingError 

-  Description: Workspace 从 Citrix Virtual Apps and Desktops 代理接收到错误。
-  Recommended action: 验证您的 Citrix Virtual Apps and Desktops 日志。联系 Citrix 支持。

BrokerGetAddressCall.ServiceConnectionError 

-  Description: Workspace 无法联系场中的任何 Citrix Virtual Apps and Desktops 代理。
  • Recommended action: 验证您的 Citrix Virtual Apps and Desktops 日志。联系 Citrix 支持。

BrokerGetAddressCall.BrokerError

  • Description: Workspace 从 Citrix Virtual Apps and Desktops 代理接收到错误。
  • Recommended action: 验证您的 Citrix Virtual Apps and Desktops 日志。联系 Citrix 支持。

BrokerGetAddressCall.LicensingError

  • Description: Workspace 无法启动应用程序，因为出现许可错误。
  • Recommended action: 验证您的 Citrix Virtual Apps and Desktops 日志。联系 Citrix 支持。

BrokerGetAddressCall.Error

  • Description: Workspace 无法从 Citrix Virtual Apps and Desktops 代理检索 VDA 详细信息。
  • Recommended action: 验证您的 Citrix Virtual Apps and Desktops 日志。联系 Citrix 支持。

GetLaunchReference.NoAccessToken

  • Description: Workspace 无法成功连接到 VDA。
  • Recommended action: 验证您的 Citrix Virtual Apps and Desktops 日志。联系 Citrix 支持。

GetLaunchReference.BrokerError

  • Description: Workspace 无法成功连接到 VDA。
    • Recommended action: 验证您的 Citrix Virtual Apps and Desktops 日志。联系 Citrix 支持。

GetLaunchReference.Error 

-  Description: Workspace 无法成功连接到 VDA。
-  Recommended action: 验证您的 Citrix Virtual Apps and Desktops 日志。联系 Citrix 支持。

GenerateIcaFile.InvalidIcaSetting

  • Description: 建立 HDX 连接时发生内部错误。
  • Recommended action: 联系 Citrix 支持。

StoreIcaFileAndGetTicket.StoreIcaFileAndCreateTicketFailed

  • Description: 建立 HDX 连接时发生内部错误。
  • Recommended action: 联系 Citrix 支持。

StoreIcaFileAndGetTicket.Error

  • Description: 建立 HDX 连接时发生内部错误。
  • Recommended action: 联系 Citrix 支持。

GetFasVdaLogonTicket.Error

  • 描述：建立 HDX 连接时发生内部错误。
  • 建议操作：请联系 Citrix 支持。

GenerateSTATicket.Error

  • 描述：建立 HDX 连接时发生内部错误。
  • 建议操作：请联系 Citrix 支持。

GetVdaAddress.Error 

-  描述：建立 HDX 连接时发生内部错误。
-  建议操作：请联系 Citrix 支持。

GetTicket.NoAccessToken

  • 描述：建立 HDX 连接时发生内部错误。
  • 建议操作：请联系 Citrix 支持。

GetTicket.BrokerError 

-  描述：Citrix Virtual Apps and Desktops 代理无法启动 HDX 会话。
-  建议操作：请验证错误消息中的 ID，并检查您的 Citrix Virtual Apps and Desktops 日志。

GetTicket.ServiceConnectionError

  • 描述：Workspace 无法联系 Citrix Virtual Apps and Desktops 代理。
  • 建议操作：请联系 Citrix 支持。

GetTicket.Error 

-  描述：建立 HDX 连接时发生内部错误。
  • 建议操作：请联系 Citrix 支持。

GetNetscalerConfigurationByCustomer.Error

  • 描述：建立 HDX 连接时发生内部错误。
  • 建议操作：请联系 Citrix 支持。

DiscoverMPSServerCapabilities.Error

  • 描述：向 Citrix Virtual Apps and Desktops 代理发出请求时出现问题。
  • 建议操作：请检查您的 Citrix Virtual Apps and Desktops 日志。请联系 Citrix 支持。

GetResourceLocationNetScalerConfig.Error

  • 描述：建立 HDX 连接时发生内部错误。
  • 建议操作：请联系 Citrix 支持。

GetCustomerResourceLocations.Error

  • 描述：建立 HDX 连接时发生内部错误。
  • 建议操作：请联系 Citrix 支持。

GetResourceLocationFromResourceProvider.Error

  • 描述：建立 HDX 连接时发生内部错误。
  • 建议操作：请联系 Citrix 支持。

GetNetScalerGatewayInfo.Error

  • 描述：建立 HDX 连接时发生内部错误。
  • 建议操作：请联系 Citrix 支持。

GetCustomerEntitlements.Error

  • 描述：建立 HDX 连接时发生内部错误。
  • 建议操作：请联系 Citrix 支持。

GetResourceLocationForServerFeed.Error

  • 描述：建立 HDX 连接时发生内部错误。
  • 建议操作：请联系 Citrix 支持。

GetResourceInformation.Error

  • 描述：建立 HDX 连接时发生内部错误。
  • 建议操作：请联系 Citrix 支持。

Citrix Gateway 服务

CGS-ICASN_ERR_00001

  • 描述：由于请求解析错误，应用程序启动失败。
  • 建议操作：请联系 Citrix 支持。

CGS-ICASN_ERR_00002

  • 描述：未能验证身份验证票证。
  • 建议操作：请联系 Citrix 支持。

CGS-ICASN_ERR_00003

  • 描述：从浏览器下载的 ICA 文件在 90 秒后用于会话启动，届时 STA 票证已过期。
  • 建议操作：请重试会话启动。

CGS-ICASN_ERR_00004

  • 描述：未能验证身份验证票证。
  • 建议操作：请联系 Citrix 支持。

CGS-ICASN_ERR_00005

  • 描述：未能建立与连接器的连接。
  • 建议操作：请验证连接器运行状况。如果问题仍然存在，请联系 Citrix 支持。

CGS-ICASN_ERR_00006

  • 描述：连接到连接器的请求超时。
  • 建议操作：请验证连接器运行状况。请验证是否有任何代理设置阻止连接器/VDA 与 NGS 之间的流量。请验证 VDA 与连接器之间的连接。如果问题仍然存在，请联系 Citrix 支持。

CGS-ICASN_ERR_00007

  • 描述：在会话建立之前，客户端计算机上的 Citrix Workspace 应用程序关闭了连接。
  • 建议操作：请重试会话启动。

CGS-ICASN_ERR_00008

  • 描述：后端关闭了连接。
  • 建议操作：验证 Connector 的运行状况。验证从 Connector/VDA 到公共网络 (NGS) 的网络稳定性。如果问题仍然存在，请联系 Citrix 支持。

CGS-ICASN_ERR_00009

  • 描述：VDA 到 NGS 连接建立失败 (Rendezvous)。
  • 建议操作：验证 Connector 的运行状况。VDA 必须能够访问 NGS 服务。验证 VDA 和 Connector 之间的连接。如果问题仍然存在，请联系 Citrix 支持。

CGS-ICASN_ERR_00010

  • 描述：EDT 回退到 TCP。验证 EDT 的先决条件。
  • 建议操作：必须启用 Rendezvous，并且 VDA 必须能够通过 UDP 访问 NGS 服务。如果问题仍然存在，请联系 Citrix 支持。

CGS-ICASN_ERR_00011

  • 描述：NGS 内部服务失败。
  • 建议操作：联系 Citrix 支持。

CGS-ICASN_ERR_00012

  • 描述：NGS 内部服务失败。
  • 建议操作：联系 Citrix 支持。

CGS-ICASN_ERR_00013

  • 描述：GCT 验证失败。
  • 建议操作：联系 Citrix 支持。

CGS-ICASN_ERR_00014

  • 描述：GCT 验证失败。
  • 建议操作：联系 Citrix 支持。

CGS-ICASN_ERR_00015

  • 描述：NGS 内部服务失败。
  • 建议操作：联系 Citrix 支持。

CGS-ICASN_ERR_00016

  • 描述：NGS 内部服务失败。
  • 建议操作：联系 Citrix 支持。

CGS-ICASN_ERR_00017

  • 描述：NGS 内部服务失败。
  • 建议操作：联系 Citrix 支持。

CGS-ICASN_ERR_00018

  • 描述：身份验证票证验证失败。
  • 建议操作：联系 Citrix 支持。

CGS-ICASN_ERR_00019

  • 描述：身份验证票证验证失败。
  • 建议操作：联系 Citrix 支持。

CGS-ICASN_ERR_00020

  • 描述：CGS 内部许可错误。
  • 建议操作：联系 Citrix 支持。

CGS-ICASN_ERR_00021

  • 描述：由于禁用了功能标志，Rendezvous v2 回退。
  • 建议操作：联系 Citrix 支持。

CGS-ICASN_ERR_00022

  • 描述：NGS 内部服务失败。
  • 建议操作：联系 Citrix 支持。

CGS-ICASN_ERR_00023

  • 描述：CLXMTP 交换超时。
  • 建议操作：验证 Connector 运行状况良好且可访问 NGS 服务。如果问题仍然存在，请联系 Citrix 支持。

CGS-ICASN_ERR_00024

  • 描述：CLXMTP VSR 验证失败。
  • 建议操作：联系 Citrix 支持。

CGS-ICASN_ERR_00025

  • 描述：CLXMTP VSR 验证失败。
  • 建议操作：联系 Citrix 支持。

CGS-ICASN_ERR_00026

  • 描述：CLXMTP 中没有可用的 Connector。
  • 建议操作：验证 Connector 在资源位置是否处于正常运行状态。如果问题仍然存在，请联系 Citrix 支持。

CGS-ICASN_ERR_00027

  • 描述：CLXMTP 重定向到 Connector 在达到最大尝试次数后失败。
  • 建议操作：验证 Connector 在资源位置是否处于正常运行状态。验证所有 Connector 中是否正在运行 Citrix ClxMtp Service 服务。联系 Citrix 支持。

CGS-ICASN_ERR_00028

  • 描述：未能与 Controller 通信。
  • 建议操作：联系 Citrix 支持。

Success: CGS_ICASN_SUCCESS_00001

  • 描述：已收到会话启动请求。
  • 建议操作：不适用

Success: CGS_ICASN_SUCCESS_00002

  • 描述：会话启动请求已完成。
  • 建议操作：不适用

XAXD proxy

XDPXY_INF_00001

  • 描述：Broker 向 VDA 发送请求，以准备传入连接。
  • 建议操作：不适用

XDPXY_INF_00002

  • 描述：VDA 确认 Broker 的连接请求。
  • 建议操作：不适用

XDPXY_ERR_00001

  • 描述：无法与 VDA 通信。
  • 建议操作：检查 Connector 的运行状况。有关详细信息，请参阅 Citrix Cloud Connector 和 CTX224133。
    • 重新启动 VDA 上的 Citrix Delivery Agent 服务或重新启动 VDA。
    • 如果 Connector 和 Broker 之间存在 Web 代理，请确保其已正确配置。
    • 如果问题仍然存在，请联系 Citrix 支持。

XDPXY_ERR_00002

  • 描述：XaxdProxy 等待 VDA 响应超时。
  • 建议操作：检查 Connector 的运行状况。有关详细信息，请参阅 Citrix Cloud Connector 和 CTX224133。
    • 重新启动 VDA 上的 Citrix Delivery Agent 服务或重新启动 VDA。
    • 如果 Connector 和 Broker 之间存在 Web 代理，请确保其已正确配置。
    • 如果问题仍然存在，请联系 Citrix 支持。

XDPXY_ERR_00003

  • 描述：尝试发出请求时遇到 WCF 故障或异常。
  • 建议操作：检查 Connector 的运行状况。有关详细信息，请参阅 Citrix Cloud Connector 和 CTX224133。
    • 重新启动 VDA 上的 Citrix Delivery Agent 服务或重新启动 VDA。
    • 如果 Connector 和 Broker 之间存在 Web 代理，请确保其已正确配置。
    • 如果问题仍然存在，请联系 Citrix 支持。

XDPXY_INF_00003

  • 描述：堆栈调用了传入 ICA 或 RDP 连接的验证请求。
  • 建议操作：不适用

XDPXY_INF_00004

  • 描述：已建立传入 ICA 或 RDP 连接的验证。
  • 建议操作：不适用

XDPXY_ERR_00001

  • 描述：无法与 VDA Proxy 通信。
  • 建议操作：检查 Connector 的运行状况。有关详细信息，请参阅 Citrix Cloud Connector 和 CTX224133。
    • 重新启动 VDA 上的 Citrix Delivery Agent 服务或重新启动 VDA。
    • 如果 Connector 和 Broker 之间存在 Web 代理，请确保其已正确配置。
    • 如果问题仍然存在，请联系 Citrix 支持。

XDPXY_ERR_00002

  • 描述：XaxdProxy 等待 VDA Proxy 响应超时。
  • 建议操作：检查 Connector 的运行状况。有关详细信息，请参阅 Citrix Cloud Connector 和 CTX224133。
    • 重新启动 VDA 上的 Citrix Delivery Agent 服务或重新启动 VDA。
    • 如果 Connector 和 Broker 之间存在 Web 代理，请确保其已正确配置。
    • 如果问题仍然存在，请联系 Citrix 支持。

XDPXY_ERR_00003

  • 描述：尝试发出请求时遇到异常。
  • 建议操作：检查 Connector 的运行状况。有关详细信息，请参阅 Citrix Cloud Connector 和 CTX224133。
    • 重新启动 VDA 上的 Citrix Delivery Agent 服务或重新启动 VDA。
    • 如果 Connector 和 Broker 之间存在 Web 代理，请确保其已正确配置。
    • 如果问题仍然存在，请联系 Citrix 支持。

XDPXY_INF_00005

  • 描述：已发出将 HDX 会话流量直接发送到 VDA 的请求。
  • 建议操作：不适用

XDPXY_INF_00006

  • 描述：VDA 与 Citrix Cloud™ 控制平面建立直接连接以传输 HDX 会话流量。
  • 建议操作：不适用

XDPXY_INF_00007

  • 描述：客户端向本地 StoreFront 发送资源连接请求。
  • 建议操作：不适用

XDPXY_INF_00008

  • 描述：本地 StoreFront 接受来自客户端的资源连接请求。
  • 建议操作：不适用

XDPXY_ERR_00004

  • 描述：XaxdProxy 尝试连接时收到 HTTP 错误响应。
  • 建议操作：检查 Connector 的运行状况。有关详细信息，请参阅 Citrix Cloud Connector 和 CTX224133。
    • 验证从 Connector 到公共网络的网络稳定性。
    • 如果 Connector 和 Broker 之间存在 Web 代理，请确保其已正确配置。
    • 如果问题仍然存在，请联系 Citrix 支持。

XDPXY_ERR_00006

  • 描述：XML 请求格式无效。
  • 建议操作：联系 Citrix 支持

XDPXY_ERR_00007

  • 描述：XML 请求的凭据标头和/或格式无效。
  • 建议操作：注销，重新登录，然后重试操作。如果问题仍然存在，请联系 Citrix 支持。

XDPXY_INF_00011

  • 描述：用户通过 WSA 请求服务连续性启动。
  • 建议操作：不适用

XDPXY_INF_00012

  • 描述：用户通过 WSA 请求服务连续性启动。
  • 建议操作：不适用

XDPXY_ERR_00004

  • 描述：XaxdProxy 尝试连接时遇到 HTTP 错误。
  • 建议操作：检查 Connector 的运行状况。有关详细信息，请参阅 Citrix Cloud Connector 和 CTX224133。
    • 如果 Connector 和 Broker 之间存在 Web 代理，请确保其已正确配置。
    • 如果问题仍然存在，请联系 Citrix 支持。

XDPXY_ERR_00008

  • 描述：服务连续性启动失败，因为 XaxdProxy 等待响应超时。
  • 建议操作：检查 Connector 的运行状况。有关详细信息，请参阅 Citrix Cloud Connector 和 CTX224133。
    • 如果 Connector 和 Broker 之间存在 Web 代理，请确保其已正确配置。
    • 如果问题仍然存在，请联系 Citrix 支持。

XDPXY_ERR_00009

  • 描述：服务连续性启动失败，因为租约被阻止和/或撤销。
  • 建议操作：请将错误详细信息告知您的 Citrix Cloud 管理员。有关详细信息，请参阅 服务连续性 文档。
    • 如果问题仍然存在，请联系 Citrix 支持。
会话启动诊断
May 4, 2026
投稿者: 
C C
May 4, 2026
投稿者: 
C C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.