Citrix 连接故障排除

Last published : Oct 24, 2026
Citrix 连接故障排除功能旨在帮助最终用户有效地自行排查潜在的桌面或应用程序启动故障。此增强功能旨在为用户提供清晰的诊断信息、潜在的建议以及通过简单点击即可运行修复程序的能力。
Related information
管理

概述

Citrix 现在提供更精细和增强的错误消息，以帮助用户清楚地了解启动故障的根本原因。连接故障排除功能在启动过程中对虚拟投递代理 (VDA) 的可达性挑战执行实时分析。然后，它会显示用户友好的错误消息和建议，使用户能够直接解决问题，或在需要时收集日志以提交支持工单。

分析的连接路径

此功能可诊断潜在的虚拟应用程序和桌面启动问题，涵盖关键连接点，包括：
  • 从客户端到网关的网络连接。
  • 网关到 StoreFront 服务器连接。
  • StoreFront 服务器到 Broker 连接。
  • Broker 到 VDA 连接。

增强的错误消息和诊断

在启动失败的情况下，Citrix 现在会显示清晰、用户友好的错误消息，这些消息会指出特定的连接问题，例如网络错误、服务器不可用或 VDA 故障。对于管理员，日志中提供了详细的错误代码，分类为服务器端和客户端错误，可作为深入调查的宝贵参考。

自我恢复和补救措施

Citrix 连接故障排除功能包括用户可以采取的步骤，以自动从常见问题中恢复，从而最大限度地减少对支持干预的需求。以下是可以通过引导式补救解决的潜在问题：
  • 重启 VDA
  • 重新启动 Citrix Workspace 应用程序 (CWA) - 重新登录 CWA
  • 刷新资源列表
  • 刷新应用程序并重试
  • 重新配置应用商店
  • 升级 CWA
  • 重新安装 CWA
  • 检查网络
  • 等待并重试

系统要求

要使用“连接故障排除”功能，请确保拥有以下 Citrix Workspace 应用程序版本：
  • 适用于 Mac 的 Citrix Workspace 应用程序： 版本 2505 及更高版本
  • 适用于 Windows 的 Citrix Workspace 应用程序： 版本 2507 及更高版本
  • 适用于 iOS 的 Citrix Workspace 应用程序： 版本 2509 及更高版本
  • 适用于 Android 的 Citrix Workspace 应用程序： 版本 2509 及更高版本

如何使用

连接故障排除功能在 Citrix DaaS 环境中默认启用。它为通过浏览器启动的会话和直接通过本机 Citrix Workspace 应用程序启动的会话提供详细且增强的错误消息以及补救建议。

重要注意事项

尽管此功能提供了强大的自助服务功能，但请务必注意以下事项：
  • “重新启动 VDA”补救操作不支持通过混合启动模式启动的会话（即从浏览器下载 ICA 文件，然后使用本机 Citrix Workspace 应用程序启动）。

错误代码

错误代码分为服务器端错误和客户端错误。以下是包含错误代码的表格。

常见服务器端错误

错误 ID 描述 建议
ResourceNotFound 资源已被管理员删除。 要获取可用应用程序和桌面的最新列表，请刷新 Citrix Workspace 应用程序或注销并重新登录。
WorkstationInMaintenance 桌面正在进行计划维护。 等待维护完成，然后重试。
UnavailableDesktop 没有可用的桌面可供连接。 请稍候几分钟，然后重试。如果问题仍然存在，请联系您的系统管理员。
UnavailableAppProtectedDesktop 打开受保护的资源需要应用程序保护。 升级到具有应用程序保护功能的 Citrix Workspace 应用程序版本，或联系您的系统管理员寻求帮助。
NotLicensed 无法启动资源，因为服务器缺少相应的许可证。 请联系您的系统管理员寻求帮助。
NoMoreActiveSessions 无法启动资源，因为没有可用的会话槽。 请稍候几分钟，然后重试。如果问题仍然存在，请联系您的系统管理员。
GeneralAppLaunchError 尝试打开资源时发生未知错误。 请联系您的系统管理员寻求帮助。
ResourceDisabled 您的管理员已禁用该资源。 要获取可用应用程序和桌面的最新列表，请刷新 Citrix Workspace 应用程序或注销并重新登录。

适用于 Windows 的 Citrix Workspace 应用程序

错误 ID 描述 建议
CertificateError 服务器证书出现错误。 请联系您的系统管理员寻求帮助。
PassthroughClientError 已存在活动会话。 请联系您的系统管理员寻求帮助。
IcaFileRetrieveError 尝试检索 ICA 文件时发生错误。 请联系您的系统管理员寻求帮助。
Icafileretrieveerrorreconnection 重新连接时尝试检索 ICA 文件时发生错误。 请联系您的系统管理员寻求帮助。
NoCWA 打开资源需要 Citrix Workspace 应用程序。 请安装 Citrix Workspace 应用程序或联系您的系统管理员寻求帮助。
CouldNotFindStore 无法检索启动资源所需的存储配置。 从 Citrix Workspace 应用程序中删除存储，然后再次添加。如果问题仍然存在，请联系您的系统管理员。
noclientinstalled 无法检索启动资源所需的信息。 刷新 Citrix Workspace 应用程序或注销并重新登录。
AuthCancelled 身份验证会话已过期。 要尝试解决此问题，请在 Citrix Workspace 应用程序中重新进行身份验证。如果问题仍然存在，请联系您的系统管理员。
IcaFileLaunchError 尝试启动 ICA 文件时发生错误。 退出并重新打开 Citrix Workspace 应用程序。如果问题仍然存在，请联系您的系统管理员。
CouldNotContactStore 尝试与 VDA 通信时发生错误。这可能是由于服务器连接问题。 退出并重新打开 Citrix Workspace 应用程序。如果问题仍然存在，请联系您的系统管理员。
CCMError 由于连接管理器错误，无法启动资源。错误代码：{errorCodeValue} 退出并重新打开 Citrix Workspace 应用程序。如果问题仍然存在，请联系您的系统管理员。
CCMInitFailed 由于连接管理器初始化失败，无法启动资源。 退出并重新打开 Citrix Workspace 应用程序。如果问题仍然存在，请联系您的系统管理员。
CCMLoadFailed 无法启动资源，因为连接管理器加载失败。 退出并重新打开 Citrix Workspace 应用程序。如果问题仍然存在，请联系您的系统管理员。
InvalidIcaParams 由于 ICA 参数不正确，无法启动资源。 退出并重新打开 Citrix Workspace 应用程序。如果问题仍然存在，请联系您的系统管理员。
AppExiting 无法启动资源，因为 Citrix Workspace 应用程序正在退出。 退出并重新打开 Citrix Workspace 应用程序。如果问题仍然存在，请联系您的系统管理员。
UTF8ConversionFailed 无法解析 ICA 文件。 退出并重新打开 Citrix Workspace 应用程序。如果问题仍然存在，请联系您的系统管理员。
MissingSoftware 您需要额外的软件才能使用此应用程序。 请联系您的系统管理员寻求帮助。

适用于 Mac 的 Citrix Workspace 应用程序

错误 ID 描述 建议
AuthCancelled 身份验证会话已过期。 要尝试解决此问题，请首先使用您的凭据进行身份验证。如果问题仍然存在，请联系您的系统管理员。
NetworkError 由于网络连接问题，无法启动资源。 检查您的连接并重试。如果问题仍然存在，请联系您的系统管理员。
ViewerNotFound 找不到 Citrix Viewer 路径。 要尝试解决此问题，请卸载并重新安装 Citrix Workspace 应用程序。如果问题仍然存在，请联系您的系统管理员。
ViewerOpenEventFailed Citrix Viewer 未能创建事件。 尝试从您的商店再次启动资源。如果问题仍然存在，请联系您的系统管理员。
ViewerLaunchTimeout Citrix Viewer 启动超时。 请尝试从您的商店再次启动资源。如果问题仍然存在，请联系您的系统管理员。
ViewerLaunchFailure Citrix Viewer 启动失败。 请尝试从您的商店再次启动资源。如果问题仍然存在，请联系您的系统管理员。
InvalidICAFile 无法启动资源，因为 ICA 文件无效。 请尝试从您的商店再次启动资源。如果问题仍然存在，请联系您的系统管理员。
CertificateError 服务器证书出现错误。 请联系您的系统管理员寻求帮助。
ResourceError 尝试启动资源时发生错误。这可能是由于服务器连接问题。 请等待几分钟，然后重试。如果问题仍然存在，请联系您的系统管理员。
UnknownError 尝试打开资源时发生未知错误。 请稍候几分钟，然后重试。如果问题仍然存在，请联系您的系统管理员。

适用于 iOS 的 Citrix Workspace 应用程序

错误 ID 描述 建议
credentialsMustChange 您的密码必须更改。 请转到您的帐户设置以更改密码。如果问题仍然存在，请联系您的系统管理员。
noConfigurationFile 无法检索所需的配置数据。 要尝试解决此问题，请从 Citrix Workspace 应用程序中删除应用商店，然后重新添加。如果问题仍然存在，请联系您的系统管理员。
http404Error 资源不可用。 请联系您的系统管理员寻求帮助。
invalidTransactionId 无效的事务 ID。 请稍候几分钟，然后重试。如果问题仍然存在，请联系您的系统管理员。
credentialsExpired 您的密码已过期。 请前往您的帐户设置更改密码。如果问题仍然存在，请联系您的系统管理员。
badAddressError 无法找到资源地址。 请检查您的连接并重试。如果问题仍然存在，请联系您的系统管理员。
accountDisabled 您的帐户已被禁用。 请联系您的系统管理员寻求帮助。
accountLockedOut 您的帐户已被暂时锁定。 请联系您的系统管理员寻求帮助。
storeServerConnectionError 尝试与服务器通信时发生错误。 请稍候几分钟，然后重试。如果问题仍然存在，请联系您的系统管理员。
internalServerError 尝试连接到服务器时发生未知错误。 请联系您的系统管理员寻求帮助。
invalidXML 由于 XML 服务错误，无法打开资源。 请联系您的系统管理员寻求帮助。
badCredentials 您的凭据已过期。 要尝试解决此问题，请退出 Citrix Workspace 应用程序，然后重新登录。如果问题仍然存在，请联系您的系统管理员。
appRemoved 资源已被您的管理员删除或禁用。 为了获取可用应用程序和桌面的最新列表，请刷新 Citrix Workspace 应用程序或注销并重新登录。
invalidLogonHours 由于管理员设置的限制，目前无法登录。 请在正常工作时间重试。如果问题仍然存在，请联系您的系统管理员。
connectionError 无法连接到服务器。这可能是由于网络连接问题。 要尝试解决此问题，请退出并重新打开 Citrix Workspace 应用程序。如果问题仍然存在，请联系您的系统管理员。

适用于 Android 的 Citrix Workspace 应用程序

错误 ID 描述 建议
http404Error 由于网络连接问题，无法启动资源。 检查您的连接并重试。如果问题仍然存在，请联系您的系统管理员。
couldNotConnectToWorkstation 无法连接到桌面。 退出并重新打开 Citrix Workspace 应用程序。如果问题仍然存在，请联系您的系统管理员。
retryReasonRebooting 启动资源时发生错误。请求的工作站正在重新启动。 退出并重新打开 Citrix Workspace 应用程序。如果问题仍然存在，请联系您的系统管理员。
retryReasonResuming 启动资源时发生错误。请求的工作站正在恢复。 退出并重新打开 Citrix Workspace 应用程序。如果问题仍然存在，请联系您的系统管理员。
generalProblem 尝试打开资源时出现问题。 退出并重新打开 Citrix Workspace 应用程序。如果问题仍然存在，请联系您的系统管理员。
retryReasonUnknown ICA 文件中发生错误。 退出并重新打开 Citrix Workspace 应用程序。如果问题仍然存在，请联系您的系统管理员。
appRemoved 资源已被您的管理员删除或禁用。 要获取可用应用程序和桌面的最新列表，请刷新 Citrix Workspace 应用程序或注销并重新登录。
resourceError 尝试启动 ICA 文件时发生错误。 请等待几分钟，然后重试。如果问题仍然存在，请联系您的系统管理员。如果是专用计算机，请重新启动 VDA。
resourceUnavailable 尝试启动 ICA 文件时发生错误。 请等待几分钟，然后重试。如果问题仍然存在，请联系您的系统管理员。如果是专用计算机，请重新启动 VDA。