Citrix Virtual Apps and Desktops

故障排除

系统性方法

在复杂的 Citrix Virtual Apps and Desktops™ (CVAD) 环境中解决打印问题需要一种系统的方法,而不是随意猜测。建议的流程包括:

  1. 识别症状: 明确定义问题(例如,打印机未显示、作业卡住、输出错误、打印缓慢)。
  2. 隔离范围: 确定受影响的人员(一个用户、多个用户、特定应用程序)、涉及哪些打印机以及问题发生在哪些 VDA 或客户端设备上。
  3. 检查基本项: 验证网络连接(VDA 到打印服务器,客户端到 VDA),确保打印机在线且在 Citrix® 外部正常工作,检查客户端的本地打印(针对重定向问题)。
  4. 审查策略: 使用 Citrix 组策略建模向导等工具或通过检查 VDA 上应用的策略设置,检查应用于受影响用户/会话的相关 Citrix 策略设置。确保策略设置按预期配置,并且没有明显的冲突。
  5. 检查日志: 检查 VDA、客户端设备和打印服务器上的 Windows 事件日志(应用程序和系统日志、PrintService 日志)(如果适用)。如果启用,请检查 Citrix 特定日志。3
  6. 测试组件: 尝试将问题隔离到特定组件 – 尝试从不同的应用程序打印,尝试不同的打印机,使用通用驱动程序(如 UPD 或 Microsoft XPS Document Writer)进行测试,检查打印后台处理程序和 Citrix 打印管理器服务的状态。
  7. 查阅资源: 利用产品文档、支持文章和社区论坛查找已知问题和解决方案。

常见问题和解决方案

下面记录了现场报告的一些常见打印问题和建议的故障排除步骤:

  • 无法自动创建打印机 / 打印机未在会话中显示:

    • 潜在原因: 客户端打印机重定向策略已禁用;自动创建客户端打印机策略设置为“无”或过滤不正确;客户端设备打印后台处理程序问题;Workspace 应用程序问题;客户端和 VDA 之间的网络连接问题;Citrix 打印管理器服务 (CpSvc.exe) 未运行或在 VDA 上崩溃;VDA 上缺少所需的打印机驱动程序(如果需要本机驱动程序);Citrix 策略未正确应用于会话。
    • 故障排除步骤:
      1. 验证客户端打印机重定向策略为“允许”,并且已为用户/会话正确配置“自动创建客户端打印机”。
      2. 检查 VDA 上的 CpSvc.exe 服务状态;如有必要,请重新启动。
      3. 检查 VDA 和客户端上的 Windows 打印后台处理程序服务状态;如有必要,请重新启动。
      4. 验证基本网络连接。
      5. 在客户端设备上本地测试打印。
      6. 确保已安装兼容的 Workspace 应用程序版本。
      7. 检查 VDA 事件日志中与 CpSvc 或打印机创建相关的错误。
      8. 在 VDA 上强制执行策略更新操作 (gpupdate /force)。
      9. 检查 VDA 上应用的策略,确认预期设置是否存在。
      10. 如果需要本机驱动程序,请验证它们是否已安装在 VDA 上。
      11. 检查 VDA 上本地/组策略中的 RDS/终端服务器打印机重定向设置。
      12. 查找并清理 VDA 注册表中的孤立打印机条目。
  • 打印后台处理程序崩溃/服务无响应(在 VDA 或打印服务器上):

    • 潜在原因: 有缺陷或不兼容的打印机驱动程序(通常是第三方);队列中损坏的打印作业;驱动程序冲突;系统资源不足。

    • 故障排除步骤:

      1. 使用 Windows 事件日志(应用程序日志通常显示后台处理程序崩溃)识别故障进程/模块。
      2. 尝试重新启动打印后台处理程序服务。
      3. 如果重启失败或问题再次出现,请尝试手动清除打印队列(停止后台处理程序服务,删除 C:\Windows\System32\spool\PRINTERS 中的文件,启动后台处理程序服务)。
      4. 识别并删除有问题的打印机驱动程序。彻底删除可能需要编辑注册表。
      5. 使用 Citrix UPD 或通用 Microsoft 驱动程序进行测试。
      6. 检查并清理注册表中孤立的打印处理器。
  • 策略冲突/设置被忽略:

    • 潜在原因: GPO 设置覆盖 Citrix 策略;Citrix 策略优先级或筛选器冲突;策略处理期间出错。

    • 故障排除步骤:

      1. 使用 Citrix 组策略建模向导模拟受影响用户/VDA 的策略应用。
      2. 验证策略筛选器(用户组、客户端 IP 等)是否正确。
      3. 检查 Studio/Web Studio 中的策略优先级设置。
      4. 暂时阻止 VDA 组织单位上的 GPO 继承,以隔离 Citrix 策略问题。
      5. 检查 VDA 上的策略处理结果(例如,使用 gpresult /h report.html 命令)。
      6. 简化应用于用户/VDA 的策略集,并逐步添加策略以找出冲突。
  • 驱动程序问题(一般性问题 - 兼容性、损坏、映射):

    • 潜在原因: 驱动程序与 VDA 操作系统或 Citrix 版本不兼容;驱动程序安装损坏;策略要求的驱动程序在 VDA 上缺失;多个驱动程序之间存在冲突;打印机驱动程序映射策略配置不正确。
    • 故障排除步骤:
      1. 尝试使用 Citrix UPD 打印(配置通用打印驱动程序使用策略)。
      2. 验证是否基于应用的策略选择了正确的驱动程序(本机或 UPD)。
      3. 确保所需的本机驱动程序已正确安装在 VDA 上(如果使用)。
      4. 查阅供应商文档,以了解驱动程序与 CVAD 和 VDA 操作系统版本的兼容性。
      5. 对有问题的驱动程序执行干净的重新安装(卸载、重启、安装)。
      6. 仔细检查并测试打印机驱动程序映射策略规则。
      7. 最大限度地减少 VDA 上安装的驱动程序数量。
  • 打印速度慢/性能问题:
    • 潜在原因: 网络拥堵或高延迟(尤其是广域网);大型、复杂的打印作业(例如,高分辨率图形);低效的打印机驱动程序;打印优化(压缩、缓存)被禁用或配置错误;低效的路由(例如,通过慢速广域网直接连接)。
    • 故障排除步骤:
      1. 分析 VDA、客户端和打印服务器之间的网络路径和性能。
      2. 配置 Citrix 带宽限制策略用于打印。
      3. 通过通用打印策略启用和配置 UPD 优化(图像压缩、字体/图像缓存)。
      4. 对于 WAN 链接,禁用“直接连接到打印服务器”策略,以强制流量通过压缩的 ICA® 通道。
      5. 如果使用 UPS,请确保其已针对网络进行优化配置。
      6. 分析打印作业本身 – 如果可能,降低分辨率或复杂性。
      7. 使用不同的驱动程序进行测试(例如,UPD 与本机驱动程序)。
  • 输出不正确(字符缺失、格式错误、方向错误):
    • 潜在原因: 文档/应用程序所需的 VDA 上缺少字体;字体替换不正确;打印机驱动程序不兼容;特定 UPD 格式问题(例如,EMF 与 XPS);应用程序错误;与本地客户端打印机上启用的高级打印功能冲突。
    • 故障排除步骤:
      1. 确保 VDA 上安装了所有必需的字体。
      2. 尝试更改通用驱动程序首选项策略顺序(例如,尝试 XPS 优先于 EMF)。
      3. 尝试从不同的应用程序打印同一文档。
      4. 尝试打印到不同的物理打印机或虚拟打印机(例如,Microsoft XPS Document Writer)。
      5. 尝试使用不同的打印机驱动程序(UPD 与本机驱动程序,或不同的本机版本)。
      6. 检查应用程序的打印设置和页面设置。
      7. 在客户端设备上的本地打印机属性中禁用“高级打印功能”。
      8. 验证用户首选项和策略中的打印方向设置。
  • Citrix 打印管理器服务 (CpSvc.exe) 崩溃/挂起:
    • 可能的原因: 无响应的打印机驱动程序在注册表中留下孤立对象;与打印相关的 Citrix 策略数据损坏;系统资源争用。
    • 故障排除步骤:
      1. 按照步骤从 VDA 注册表中清除孤立的打印机和打印处理器条目。首先需要停止打印后台处理程序和 CpSvc 服务。
      2. 识别并删除有问题的打印机驱动程序。
      3. 考虑清理 VDA 上的 Citrix 策略缓存文件夹/注册表项并强制刷新策略。
      4. 监控 VDA 资源使用情况(CPU、内存)。
      5. 重启 CpSvc 和打印后台处理程序服务。
  • PDF 打印机问题:
    • 可能的原因: 自动创建 PDF 通用打印机策略已禁用;VDA 或 Workspace 应用程序版本不兼容;客户端端点上未安装 PDF 查看器;使用了不受支持的浏览器(例如 Edge)或 HTML5 配置错误(CSP 标头、config.js)。
    • 故障排除步骤:
      1. 验证自动创建 PDF 通用打印机策略已启用并应用。
      2. 确认 VDA 和 Workspace 应用程序满足最低版本要求。
      3. 确保客户端上安装了受支持的 PDF 查看器(例如 Adobe Reader、Chrome)并将其设置为默认值。
      4. 如果使用 HTML5 Workspace 应用程序,请验证浏览器兼容性并检查 configuration.js 和 CSP 标头设置。
      5. 策略更改后重新启动 Citrix 会话。

基本最终用户故障排除

如果组织策略允许,遇到简单打印问题的用户有时可以通过基本步骤自行解决,然后再上报给 IT 部门 -

  • 完全注销 HDX™ 会话并重新登录。
  • 检查端点设备上本地打印机的状态(确保它在线、未暂停、无错误)。
  • 重新启动本地端点设备。
故障排除