产品文档
Citrix DaaS™
查看 PDF

Citrix 连接故障排除

May 4, 2026
投稿者: 
C

Citrix 连接故障排除功能旨在使用户能够有效地自行排查潜在的桌面或应用程序启动失败。此增强功能旨在为用户提供清晰的诊断信息、潜在的建议以及一键运行修复程序的能力。

概述

  • 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 app 或注销并重新登录。
invalidLogonHours 由于您的管理员设置的限制，此时无法登录。 请在正常工作时间重试。如果问题仍然存在，请联系您的系统管理员。
connectionError 无法连接到服务器。这可能是由于网络连接问题。 要尝试解决此问题，请退出并重新打开 Citrix Workspace。如果问题仍然存在，请联系您的系统管理员。

Citrix Workspace app for Android

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

在本文中

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