故障排除

Last published : Oct 24, 2026

如何检查应用程序版本

要了解您正在使用的 Citrix Workspace 应用程序版本，请参阅帮助文档中的文章如何检查应用程序版本。

如何升级到最新版本

要手动将 Citrix Workspace 应用程序升级到最新版本，请执行以下操作：
  1. 打开 Play 商店。
  2. 搜索 思杰工作区。
    如果有可用更新，请点击更新。

自动更新应用程序

默认情况下，当满足以下条件时，应用程序会自动更新：
  • 设备已连接到 Wi-Fi 网络。
  • 设备正在充电。
  • 设备处于空闲状态（未被主动使用）。
  • Citrix Workspace 应用程序未在前台运行。
注意：
Google Play 商店每天检查一次应用更新。因此，应用更新可能需要长达 24 小时才能添加到更新队列中。应用添加到队列后，下次满足条件时将自动更新。

如何重置 Citrix Workspace 应用程序

要重置应用程序，您可以执行以下任一操作：
  • 清除 Citrix Workspace 应用程序存储数据。转到 Android 设备设置 > 应用 > 选择 Citrix Workspace 应用程序 > 存储 > 清除缓存。
    或
  • 卸载 Citrix Workspace 应用程序，然后从 Google Play 安装包含最新修复程序的最新版适用于 Android 的 Citrix Workspace 应用程序。
注意
从 Citrix Workspace 应用程序中删除现有帐户会重置帐户，而不是重置 Citrix Workspace 应用程序本身。

如何收集日志

日志收集很重要，因为它可以帮助识别问题。从 24.3.5 版本开始，日志文件现在包含更全面的信息，可以帮助 IT 管理员和客户支持团队更好地分析情况。
有关详细信息，请参阅帮助文档中的文章 如何收集日志。

如何提供反馈

您可以使用相同的界面向我们发送有关适用于 Android 的 Citrix Workspace 应用程序的反馈并报告问题。有关详细信息，请参阅帮助文档中的文章 如何提供反馈。

如何请求增强功能

要请求适用于 Android 的 Citrix Workspace 应用程序功能增强，请填写 Google 表单。

如何访问技术预览功能

要了解技术预览功能，请参阅技术预览中的功能。

如何提供 EAR 反馈

您可以在以下网址提供 EAR 反馈：https://forms.gle/joYc7K5teg4zcWNr7。

常见问题和故障排除技巧

安装失败

如果 Android TV 默认不支持 Citrix Workspace 应用程序，请通过增强请求联系我们。

身份验证和应用商店添加

如果您发现身份验证或应用商店添加方面的问题，请检查以下内容。

无效输入

您可能输入了：
  • 无效凭据
  • 不正确的应用商店 URL
  • 输入凭据和应用商店 URL 时出现拼写错误
  • HTTP 而不是 HTTPS。

Web 界面模式

您也可以尝试使用 Web Interface 模式。在应用程序的第一页上，点击 Get started。在 Welcome 页面上，输入商店 URL 并启用 Add acount type as Web Interface。
Web 界面(/en-us/citrix-workspace-app-for-android/media/webinterface.png)

智能卡

如果智能卡身份验证不起作用，请安装 baiMobile Credentials 应用程序。如果 baiMobile Credentials 应用程序检测到您的智能卡，请联系我们以进一步调查此问题。
baiMobile 凭据(/en-us/citrix-workspace-app-for-android/media/baimobile.png)

NetScaler® 策略配置

要解决连接问题，请参阅知识中心文章 NetScaler Gateway for mobile devices。

会话启动

要查看会话统计信息：
  • 从会话工具栏中，点击鼠标指针图标四次
    或
  • 在会话终端中运行 ctxsession -v 命令。

无法启动桌面

要进行故障排除，请参阅以下知识中心文章：

访问外设的权限

启用正确的设置权限。

客户端选择性信任

启用麦克风、位置和摄像头的设置。转到 Citrix Workspace 应用程序设置 > 应用商店设置，并针对选定的应用商店启用 CST 设置。
待添加到媒体文件夹中

启用鼠标指针

启动会话后，轻按工具栏并轻按鼠标指针图标以启用鼠标指针。
鼠标指针图标

启用键盘

如果您的组织管理员默认情况下未启用自动键盘显示功能，请联系您的组织管理员以获得进一步帮助。
管理员必须在 DDC 设置中启用自动键盘显示策略。
自动键盘策略

越狱设备

越狱设备是指其所有者已对其进行修改的设备，通常是为了绕过安全保护。当用户连接越狱的 Android 设备时，这些设备会对您的部署构成安全风险。当适用于 Android 的 Citrix Workspace 应用程序对越狱的 Android 设备进行基本检测时，该应用程序会向用户显示警报。
警报
为了进一步帮助保护您的环境，您可以配置 StoreFront™ 或 Web Interface，以帮助阻止检测到的越狱设备运行应用程序。
注意：
Citrix Workspace™ 应用程序在检测到越狱设备时会自行停用，以保护数据并维护安全性。这可确保该应用程序无法在未经授权修改的设备上使用。
要求：
  • 适用于 Android 的 Citrix Workspace 应用程序 24.7.0 或更高版本。
  • 通过管理员帐户访问 StoreFront 或 Web Interface。
有关详细信息，请参阅越狱设备。

始终开启跟踪 (AOT)

从版本 26.3.0 (2603) 开始，适用于 Android 的 Citrix Workspace 应用程序支持始终开启跟踪 (AOT)，持续捕获用户会话和系统事件的可读诊断日志，以简化故障排除并减少对 Citrix 支持的依赖。
有关详细信息，请参阅 Citrix Virtual Apps and Desktops™ 文档中的从 Citrix Virtual Apps and Desktops 核心组件上传 AOT 日志。

常见问题

  • 如何改善低功耗设备或移动设备的虚拟应用和虚拟桌面视频用户体验？
  • 访问资源 - 登录 Citrix Workspace 应用程序后，我无法看到我的应用程序或桌面？
    • 请联系您公司的帮助台或 IT 支持团队管理员以获得进一步帮助。
  • 如何排查连接缓慢的问题？
    • 如果您遇到以下任何问题，请遵循此变通办法：
    • 连接到 Citrix Virtual Apps and Desktops 站点的速度缓慢
    • 应用程序图标缺失
    • 反复出现 Protocol Driver Error 消息
    变通办法：
    • 禁用以下设备上网络接口的 Citrix PV Ethernet Adapter 属性：
    • Citrix Virtual Apps™ 服务器
    • Citrix 安全 Web 网关™
    • Web Interface 服务器
    • Citrix PV Ethernet Adapter 属性包括（默认全部启用）：
    • 大型发送卸载
    • 卸载 IP 校验和
    • 卸载 TCP 校验和
    • 卸载 UDP 校验和
    无需重新启动服务器。此解决方法适用于 Windows Server 2003 和 2008 32 位版本。此问题不影响 Windows Server 2008 R2。
  • 数字键和特殊字符问题
    • 如果数字键或中文 IME 字符无法正常工作，请禁用Unicode 键盘选项。为此，请转到设置 > 键盘选项 > 并将使用 Unicode 键盘设置为已禁用。

故障排除错误代码

下表列出了错误代码及其可能的解决方案：
错误代码 知识中心文章
错误代码 437 https://support.citrix.com/article/CTX463401
错误代码 41E https://support.citrix.com/article/CTX235177
错误代码 546 或 547 https://support.citrix.com/article/CTX231798
错误代码 518 https://support.citrix.com/article/CTX277571
错误代码 42B https://support.citrix.com/article/CTX260992
错误代码 548 https://support.citrix.com/article/CTX250706
https://support.citrix.com/article/CTX578359
服务器地址不正确 + 错误代码 548 https://support.citrix.com/article/CTX554245
错误代码 451 https://support.citrix.com/article/CTX256708
一般错误 https://support.citrix.com/article/CTX219073
请尝试重新连接 禁用 UDP 选项。转到应用程序 设置 > 高级 > EDT

错误消息和说明

下表列出了错误及其说明。可能的解决方案是联系 Citrix 技术支持 以获得进一步帮助：
错误 说明
SessionManager.Launch.EngineLoadFailed ICA 引擎加载/初始化失败。
SessionManager.Launch.ConnectionFailed ICA 引擎在连接前终止。
SessionManager.Launch.LogonFailed 会话已断开连接，未完成登录
SessionManager.LeaseResolution.Failed 无法尝试租约启动。
SessionManager.clxmtp.SoftDeny Engine CLXMTP 协商失败（软拒绝）。
SessionManager.clxmtp.SoftDeny_Implicit Engine CLXMTP 连接失败（隐式软拒绝）。
Transport.Connect.NoCGP_Fail 连接失败（CGP 已禁用）。
Transport.Connect.FallbackFail 连接失败，已尝试 ICA 回退。
Transport.Connect.Fail 连接不可用。

Citrix 疑难解答连接

Citrix 疑难解答连接功能旨在帮助最终用户有效自行排查潜在的桌面或应用程序启动失败问题。此增强功能旨在为用户提供清晰的诊断、潜在的建议以及通过简单点击即可运行修复的能力。

工作原理

此功能提供更精细和增强的错误消息，以帮助用户清楚地了解启动失败的根本原因。疑难解答连接功能在启动过程中实时分析与虚拟投递代理 (VDA) 的连接问题。然后，它会显示用户友好的错误消息和建议，使用户能够直接解决问题或在需要时收集日志以提交支持工单。

分析的连接路径

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

增强的错误消息和诊断

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

自我恢复和修复操作

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

系统要求

要使用“连接故障排除”功能，请确保 Citrix Workspace 应用程序版本满足以下要求：
适用于 Android 的 Citrix Workspace 应用程序： 版本 25.9.0 及更高版本
注意：
错误消息包含来自 (/zh-cn/citrix-daas/manage-deployment/troubleshoot-connection.html#error-codes) 部分的云存储的服务器错误代码。
“连接故障排除”功能在 DaaS 环境中默认启用。浏览器启动的会话和通过 Citrix Workspace 应用程序启动的会话均可获得详细的错误消息和建议。错误代码和事务 ID 会记录在日志中，供管理员参考。错误代码分为服务器端或客户端。对于某些错误，提供了重新启动 Virtual Delivery Agent (VDA) 的修复选项。此功能不支持混合模式下的会话。例如，当您在浏览器中下载 ICA 文件，然后使用 Citrix Workspace 应用程序打开该文件时，无法使用此功能。