使用 Monitor 进行实时会话故障排除

Last published : Oct 24, 2026
管理员可以使用 Monitor 控制台实时监控和排除 Secure Private Access 会话的故障。
有关相关信息，请参阅以下主题：
Related information
分类和故障排除

诊断日志错误代码

下表提供了用户在使用 Secure Private Access 服务时可能遇到的各种错误及其相应的解决方案的完整列表。
信息代码 描述 解决方案
0x180022 应用程序启动失败，因为身份验证服务已关闭 应用程序启动失败，因为身份验证服务已关闭
0x1800B7 应用程序启动失败，因为应用程序 FQDN 长度超出限制 应用程序启动失败，因为应用程序 FQDN 长度超出限制
0x1800A0, 0x1800A2, 0x1800A3, 0x1800A5, 0x1800A6, 0x1800A7 Web 应用程序启动失败，因为无法连接到后端 Web 应用程序 Web 应用程序启动失败，因为无法连接到后端 Web 应用程序
0x18001A, 0x18001B 未找到用户详细信息 未找到用户详细信息
0x1800AA Web/SaaS 应用程序启动失败，因为在准备 SAML 令牌时未找到用户属性 Web/SaaS 应用程序启动失败
0x180010 Web/SaaS 应用程序启动失败，因为无法识别应用程序 FQDN Web/SaaS 应用程序启动失败，因为无法识别应用程序 FQDN
0x180040 Web/SaaS 应用程序启动失败，原因是 SAML 服务提供商提供了无效的 appId 应用程序启动失败，原因是 SAML 服务提供商提供了无效的 appId
0x180011, 0x180012, 0x180013, 0x180017, 0x180032, 0x180033, 0x180034, 0x180035, 0x180048 Web/SaaS 应用程序启动失败，原因是应用程序访问请求无效 Web/SaaS 应用程序启动失败，原因是应用程序访问请求无效
0x1800D4, 0x1800E1, 0x180106, 0x180107, 0x1800EB, 0x1800EC 应用程序启动在策略评估期间失败，原因是内部错误 应用程序启动在策略评估期间失败，原因是内部错误
0x1800D9 应用程序启动在解析策略评估响应时失败 应用程序启动在解析策略评估响应时失败
0x1800DA 应用程序启动在策略评估期间因结果无效而失败 应用程序启动在策略评估期间因结果无效而失败
0x1800DB 应用程序启动失败，原因是资源位置配置无效 应用程序启动失败，原因是资源位置配置无效
0x1800E0 应用程序启动失败，原因是应用程序名称的长度过长 应用程序启动失败，原因是应用程序名称的长度过长
0x1800EE 应用程序启动失败，原因是在连接到专用 TCP 服务器期间应用程序 ID 无效 应用程序启动失败，原因是在连接到专用 TCP 服务器期间应用程序 ID 无效
0x1800E3 应用程序启动在策略评估期间被拒绝 应用程序启动在策略评估期间被拒绝
0x1800EA 应用程序启动失败，原因是目标 FQDN 过长 应用程序启动失败，原因是目标 FQDN 过长
0x1800ED 应用程序启动失败，因为目标 IP 无效 应用程序启动失败，因为目标 IP 无效
0x180102 应用程序启动失败，因为未从连接器设备收到响应 应用程序启动失败，因为未从连接器设备收到响应
0x10000005 Web/SaaS 应用程序启动失败，因为无法与后端应用程序服务器建立连接 Web/SaaS 应用程序启动失败，因为无法与后端应用程序服务器建立连接
0x10000101, 0x10000102, 0x10000103, 0x10000104 Web/SaaS FormFill SSO 失败，因为应用程序配置无效 Web/SaaS FormFill SSO 失败，因为应用程序配置无效
0x10000202 Web/SaaS 的 Kerberos SSO 失败 Web/SaaS 的 Kerberos SSO 失败
0x10000203 Web/SaaS SSO 因内部服务器错误而失败 Web/SaaS SSO 因内部服务器错误而失败
0x10000303, 0x10000304 Web/SaaS 应用程序启动失败，因为配置的代理不可达 Web/SaaS 应用程序启动失败，因为配置的代理不可达
0x10000305 Web/SaaS 应用程序启动失败，因为无法通过配置的代理进行身份验证 Web/SaaS 应用程序启动失败，因为无法通过配置的代理进行身份验证
0x10000414 应用程序启动失败，因为请求来自无效的 IP/主机名或端口 应用程序启动失败，因为请求来自无效的 IP/主机名或端口
0x10000415 应用程序启动失败，因为目标服务器拒绝了连接 应用程序启动失败，因为目标服务器拒绝了连接
0x10000416 应用程序启动失败，因为未找到目标 应用程序启动失败，因为未找到目标
0x10000417 应用程序启动失败，因为目标网络不可达 应用程序启动失败，因为目标网络不可达
0x10000405 应用程序启动失败，因为无法连接到目标 应用程序启动失败，因为无法连接到目标
0x10000301 连接器到 SPA 服务的连接失败 连接器到 Secure Private Access 服务的连接失败
0x10000302 连接器未能读取代理详细信息 连接器未能读取代理详细信息
0x10000306 配置的代理不可达 配置的代理不可达
0x10000401 连接器设备无法连接到 FR 连接器设备无法连接到 FR (边缘节点)
0x10000403, 0x10000404, 0x10000407 由于内部连接错误，应用程序启动失败 由于内部连接错误，应用程序启动失败
6003, 6007 Citrix Secure Access 客户端未能执行 SSO Citrix Secure Access 客户端未能执行 SSO

应用程序启动失败，因为身份验证服务已关闭

信息代码： 0x180022
Secure Private Access 允许管理员配置第三方身份验证服务，例如传统的 Active Directory、AAD、Okta 或 SAML。这些身份验证服务的中断可能导致此问题。
检查第三方服务器是否已启动并可访问。

应用程序启动失败，因为应用程序 FQDN 长度超出限制

信息代码： 0x1800B7
应用程序 FQDN 不得超过 512 个字符。请检查应用程序配置页面中的应用程序 FQDN，确保其未超出此限制。
  1. 转到管理控制台中的应用程序选项卡。
  2. 查找 FQDN 超过 512 个字符的应用程序。
  3. 编辑应用程序并修复应用程序 FQDN 长度。

Web 应用程序启动失败，因为无法连接到后端 Web 应用程序

信息代码： 0x1800A0, 0x1800A2, 0x1800A3, 0x1800A5, 0x1800A6, 0x1800A7
企业网络中运行的 Web 应用程序的浏览体验中断。
  1. 筛选诊断日志，查找无法解析的 FQDN。
  2. 检查从企业网络内部到后端服务器的可达性。
  3. 检查代理设置，查看连接器是否被阻止访问后端服务器。

未找到用户详细信息

信息代码： 0x18001A, 0x18001B
Secure Private Access 服务处理请求时未找到域用户详细信息。当 Citrix Cloud™ 中缺少必要的域用户属性时，可能会出现此问题。
  1. 确保 Citrix Cloud Connector™ 在将用户同步到 Citrix Cloud 时没有问题。
  2. 确保 Citrix Cloud > Identity and Access Management 中的域可访问。
  3. 注销并重新登录 Citrix Workspace。

由于在准备 SAML 令牌时未找到用户属性，Web/SaaS 应用程序启动失败

信息代码： 0x1800AA
Secure Private Access 服务在准备 SAML 令牌时未找到必需的用户属性。当 Citrix Cloud 中缺少必需的域用户属性时，可能会出现此问题。
  1. 确保 Citrix Cloud Connector 在将用户同步到 Citrix Cloud 时没有问题。
  2. 确保 Citrix Cloud > Identity and Access Management 中的域可访问。
  3. 注销并重新登录 Citrix Workspace。

由于无法识别应用程序 FQDN，Web/SaaS 应用程序启动失败

信息代码： 0x180010
未找到给定域名的应用程序。
确保域名长度不超过配置限制。

由于 SAML 服务提供商提供了无效的 appId，Web/SaaS 应用程序启动失败

信息代码： 0x180040
SAML 服务提供商提供的 AppId 无效。无法通过 SAML 服务提供商提供的给定应用 ID 找到该应用。
  1. 检查 SAML 服务提供商配置。
  2. 确保在 SAML 服务提供商处配置的 IdP URL 是正确的。
  3. 此应用 ID 必须与在 Secure Private Access 服务中配置的应用相对应。

由于应用访问请求无效，Web/SaaS 应用启动失败

信息代码： 0x180011, 0x180012, 0x180013, 0x180017, 0x180032, 0x180033, 0x180034, 0x180035, 0x180048
由于 Secure Private Access 服务收到无效请求，应用访问失败。
无法识别 Secure Private Access 服务收到的应用程序。收到的请求参数可能无效。
  1. 重新启动应用程序或注销并重新登录 Citrix Workspace。
  2. 如果问题仍然存在，请联系 Citrix 支持。

由于内部错误，应用在策略评估期间启动失败

信息代码： 0x1800D4, 0x1800E1, 0x180106, 0x180107, 0x1800EB, 0x1800EC
请联系 Citrix 支持，并提供事务 ID 和客户端收集的调试日志。

解析策略评估响应时应用启动失败

信息代码： 0x1800D9
应用程序配置可能包含特殊字符，或者策略配置可能存在问题。
确保 TCP/UDP/HTTP 应用程序配置不包含不支持的字符。
  1. 在 Secure Private Access 管理控制台中，单击“应用程序”。
  2. 检查应用程序名称或目标是否包含任何特殊字符。
检查策略是否配置正确并已分配给正确的应用程序。
  1. 在 Secure Private Access 管理门户中，单击“访问策略”。
  2. 检查策略配置、策略名称和条件。
  3. 检查策略是否已分配给正确的应用程序。
如果配置正确，请联系 Citrix 支持部门，并提供事务 ID 和客户端调试日志。

应用程序启动失败，策略评估期间结果无效

信息代码： 0x1800DA
可能存在应用程序或策略配置问题。确保 TCP/UDP/HTTP 应用程序配置不包含不支持的字符。
  1. 在 Secure Private Access 管理控制台中，单击“应用程序”。
  2. 检查应用程序名称或目标域/FQDN 是否包含任何特殊字符。
  3. 还要检查目标 IP/IP 范围/IP CIDR 是否有效。
确保应用程序域表（安全私有访问 > 设置 > 应用程序域）已启用应用程序目标条目。
检查策略是否已正确配置并分配给正确的应用程序。
  1. 在安全私有访问管理门户中，单击访问策略。
  2. 查看策略配置、策略名称和条件。
  3. 检查策略是否已分配给正确的应用程序。

应用程序启动失败，资源位置配置无效

信息代码： 0x1800DB
资源位置和配置可能存在问题
确保已配置资源位置。
  1. 登录到 Citrix Cloud 门户，然后从菜单中单击资源位置。
  2. 检查是否已配置预期的资源位置。
确保资源位置健康且处于活动状态。
  1. 登录到 Citrix Cloud 门户，然后从菜单中单击资源位置。
  2. 检查预期的资源位置是否处于活动状态且健康。
确保在应用程序域表（安全私有访问 > 设置 > 应用程序域）中为目标选择了正确的资源位置。
  1. 在 Secure Private Access 管理控制台中单击设置。
  2. 单击应用程序域选项卡。
  3. 检查访问的目标是否配置了正确的资源位置。
  4. 检查访问的目标条目在应用程序域表中是否处于活动状态。
    在 TCP/UDP/HTTP 应用程序中配置的目标会自动添加到应用程序域表中。建议不要删除/禁用活动 TCP/UDP/HTTP 应用程序的目标/URL。

应用程序启动失败，因为应用程序名称的长度过长

信息代码： 0x1800E0
请联系 Citrix 支持并提供事务 ID 和客户端收集的调试日志。

应用程序启动失败，原因是在与专用 TCP 服务器建立连接期间应用程序 ID 无效

信息代码： 0x1800EE
请联系 Citrix 支持并提供事务 ID 和客户端收集的调试日志。

应用程序启动在策略评估期间被拒绝

信息代码： 0x1800E3
请联系 Citrix 支持并提供事务 ID 和客户端收集的调试日志。

应用程序启动失败，因为目标 FQDN 过长

信息代码： 0x1800EA
确保 FQDN 长度小于 256 个字符。

应用程序启动失败，因为目标 IP 无效

信息代码： 0x1800ED
仅从客户端访问有效的私有 IP 地址。

应用程序启动失败，因为未收到来自连接器设备的响应

信息代码： 0x180102
检查连接器设备的可达性。

应用程序启动失败，因为请求来自无效的 IP/主机名或端口

信息代码： 0x10000414
检查主机名、IP 地址或端口号的有效性。

应用程序启动失败，因为目标服务器拒绝了连接

信息代码： 0x10000415
检查目标服务器的状态。

应用程序启动失败，因为未找到目标

信息代码： 0x10000416
检查目标服务器主机名。

由于目标网络不可达，应用程序启动失败

信息代码： 0x10000417
连接器设备与后端私有 TCP/UDP 服务器存在连接问题。检查 连接器设备的网络设置。
  • 检查最终用户尝试连接的后端服务器是否正在运行并能够接收请求。
  • 检查从公司网络内部访问后端服务器的可达性。
  • 检查代理设置，查看连接器是否被阻止访问后端服务器。
  • 如果请求是基于 FQDN 的应用程序，请检查 DNS 服务器中相应应用程序的 DNS 条目。

由于无法连接到目标，应用程序启动失败

信息代码： 0x10000405
连接器设备与后端私有 TCP/UDP 服务器存在连接问题。检查 连接器设备的网络设置。
  • 检查最终用户尝试连接的后端服务器是否正在运行并能够接收请求。
  • 检查从公司网络内部访问后端服务器的可达性。
  • 检查代理设置，查看连接器是否被阻止访问后端服务器。
  • 如果是基于 FQDN 的应用程序请求，请检查 DNS 服务器中相应应用程序的 DNS 条目。

连接器到 Secure Private Access 服务的连接失败

信息代码： 0x10000301
  • 查找错误代码的事务 ID。
  • 在 Secure Private Access 控制板中筛选所有与事务 ID 匹配的事件。
  • 检查其他组件中是否发生与事务 ID 匹配的任何错误，如果发现，请执行与该错误代码匹配的相应解决方法。
  • 如果在其他组件中未发现错误，请执行以下操作：
  • 请联系 Citrix 支持，并提供此诊断报告、数据包跟踪以及错误代码和事务 ID。

连接器未能读取代理详细信息

信息代码： 0x10000302
连接器设备与后端专用 TCP/UDP 服务器存在连接问题。请检查连接器设备的网络设置。
  • 检查最终用户尝试连接的后端服务器是否已启动并正在运行，并且能够接收请求。
  • 检查企业网络内部后端服务器的可达性。
  • 检查代理设置，查看连接器是否被阻止访问后端服务器。
  • 如果是基于 FQDN 的应用程序请求，请检查 DNS 服务器中相应应用程序的 DNS 条目。

配置的代理不可达

信息代码： 0x10000306
连接器设备与后端私有 TCP/UDP 服务器存在连接问题。检查 连接器设备的网络设置。
  • 检查最终用户尝试连接的后端服务器是否已启动并正在运行，并且能够接收请求。
  • 检查企业网络内部后端服务器的可达性。
  • 检查代理设置，查看连接器是否被阻止访问后端服务器。
  • 如果是基于 FQDN 的应用程序请求，请检查 DNS 服务器中相应应用程序的 DNS 条目。

连接器设备无法访问 FR（边缘节点）

信息代码： 0x10000401
检查与 Citrix Secure Private Access 服务的网络连接。
有关详细信息，请参阅 连接器设备的网络设置。

由于内部连接错误，应用程序启动失败

信息代码： 0x10000403, 0x10000404, 0x10000407
  • 查找错误代码的事务 ID。
  • 在 Secure Private Access 控制板中筛选与事务 ID 匹配的所有事件。
  • 检查与事务 ID 匹配的其他组件中是否发生任何错误。如果发现错误，请执行与该错误代码匹配的相应解决方法。
  • 如果在其他组件中未发现错误，请执行以下操作：
  • 请联系 Citrix 支持人员，并提供此诊断报告、数据包跟踪以及错误代码和事务 ID。

Web/SaaS 应用程序启动失败

由于无法与后端应用程序服务器建立连接，Web/SaaS 应用程序启动失败。
信息代码： 0x10000005
检查目标 URL 或检查连接器设备网络设置。有关详细信息，请参阅 连接器设备的网络设置。

由于应用程序配置无效，Web/SaaS FormFill SSO 失败

信息代码： 0x10000101, 0x10000102, 0x10000103, 0x10000104
检查 SSO 表单应用程序配置，并确保在应用程序设置中正确配置了用户名、密码、操作和登录 URL 字段。

Web/SaaS 的 Kerberos SSO 失败

信息代码： 0x10000202
Web/SaaS 的 Kerberos SSO 失败，原因可能是 Connector Appliance 内部服务器错误，或者无法从域控制器获取令牌。
检查后端服务器和域控制器上的 Kerberos SSO 设置。同时检查回退 NTLM 身份验证设置。
有关详细信息，请参阅 验证您的 Kerberos 配置。

Web/SaaS SSO 因内部服务器错误而失败

信息代码： 0x10000203
检查 Secure Private Access 服务和后端服务器中的 SSO 设置。对于 Secure Private Access 服务，请参阅 设置首选登录方法。

Web/SaaS 应用程序启动失败，因为配置的代理无法访问

信息代码： 0x10000303, 0x10000304
检查代理服务器设置，并确保 Connector Appliance 可以访问它。有关详细信息，请参阅 将您的 Connector Appliance 注册到 Citrix Cloud。

Web/SaaS 应用程序启动失败，因为无法通过配置的代理进行身份验证

信息代码： 0x10000305
检查代理服务器凭据，并确保它们在 Connector Appliance 中配置正确。有关详细信息，请参阅 注册您的 Connector Appliance 后。

Citrix Secure Access™ 客户端未能执行 SSO

信息代码： 6003
从 Broker Agent 服务检索 Secure Private Access 单点登录句柄时出错。
检查交付组上是否启用了 Secure Private Access SSO 标志。有关详细信息，请参阅 从 VDA 上的 Citrix Secure Access 客户端无缝登录。
信息代码： 6007
登录 Secure Private Access 失败。
如果 Citrix Secure Access 客户端会话超时，请重新启动 VDA。

会话代码

代码 状态 描述
2101 失败 会话失败
2102 活动/非活动/失败 会话处于活动状态或已终止，或者会话中至少有一个应用程序启动失败
2000 活动 会话处于活动状态
2001 非活动 会话已终止/非活动

应用程序枚举消息代码

代码 状态 描述
1000 成功 枚举成功。至少枚举了一个应用程序
1001 成功 未枚举任何应用程序，因为它们都被策略拒绝了
1002 成功 未枚举任何应用程序，因为没有策略匹配
1003 成功 未枚举任何应用程序，因为有些被拒绝，而另一些没有策略匹配
1004 成功 未枚举任何应用程序，因为没有要评估的策略
1101 失败 枚举过程中发生内部错误
1102 失败 某些应用程序已枚举，但至少有一个应用程序评估失败
1103 失败 没有枚举任何应用程序，并且至少有一个应用程序评估失败
3000 允许 允许应用程序枚举
3001 拒绝 应用程序枚举被策略拒绝
3002 拒绝 未枚举应用程序，因为没有策略匹配
3003 未知 应用程序枚举状态未知
3004 从 CEB 启动应用程序 尝试从 Citrix Enterprise Browser™ 启动应用程序
3101 失败 应用程序枚举 - 发生内部错误（当前未使用）
3102 失败 由于策略评估期间发生异常，应用程序未被枚举
3103 失败 应用程序枚举状态为空 - 策略评估期间发生内部错误
3104 允许/拒绝/失败 检索应用程序策略详细信息时出错

应用程序启动消息代码

代码 状态 描述
4000 允许 允许应用程序启动
4001 拒绝 由于策略原因，应用程序启动被拒绝
4002 拒绝 应用程序启动被拒绝，因为没有匹配的策略
4101 失败 应用程序启动错误 - 应用程序启动期间发生内部错误
4102 失败 应用程序启动错误（内部）
4103 允许/拒绝/失败 检索应用程序策略详细信息时出错
4104 失败 应用程序启动错误 - 未找到应用程序配置

应用程序启动错误代码

代码 描述 解决方案/变通方法
5001 TCP - 连接失败 验证到目标的网络可达性（从 NetScaler Gateway ping -S <SNIP>）。
5003 TCP - 探测失败
5002 TCP - 代理服务器已关闭 确保代理主机已启动。
5004 TCP - 网关内存分配失败 启用调试级别日志记录并从 NetScaler 收集支持包。
5005 TCP - 服务器宕机 验证到目标的网络可达性（从 NetScaler Gateway ping -S <SNIP>），并检查服务器是否宕机。
5006 TCP - 代理连接失败 确保代理主机已启动并接受连接。
5007 TCP - 代理探测失败 验证到目标的网络可达性（从 NetScaler Gateway ping -S <SNIP>）。启用调试级别日志记录并从 NetScaler 收集支持包。
5008 SPA - 服务器宕机 验证 Secure Private Access 站点 URL 是否已启动。（使用 NetScaler CLI 上的 show vpn securePrivateAccessProfile CLI 命令检查 URL 状态）。
5009 SPA - 呼出请求错误 验证 Secure Private Access 站点 URL 是否已启动。启用调试级别日志记录并从 NetScaler 收集支持包。
5010 SPA - 呼出响应错误
5011 TCP - 会话已过期 这表示在用户会话不再处于活动状态时访问了应用程序。启动新的活动用户会话。
5013 TCP - 网关内部错误 启用调试级别日志记录并从 NetScaler 收集支持包。
5014 TCP - DNS 服务器已关闭 确保 DNS 服务器已启动。
5015 TCP - 网关 DNS 内部错误 确保 DNS 服务器已启动。启用调试级别日志记录并从 NetScaler 收集支持包。
5016 目标服务器连接失败 验证到目标的网络可达性（从 NetScaler Gateway 使用 ping -S <SNIP>）。
5017 目标服务器 DNS 解析失败 确保您的应用程序使用的主机名由预期的 DNS 服务器（内部或公共）解析。
5018 网关内部错误 启用调试级别日志记录并从 NetScaler 收集支持包。
0x1300000C 应用程序域的 DNS 解析失败 确保您的应用程序使用的主机名由预期的 DNS 服务器（内部或公共）解析。