故障排除

系统方法

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

常见问题和解决方案

• 无法自动创建打印机/打印机未在会话中显示：
  • 潜在原因： 客户端打印机重定向策略已禁用；自动创建客户端打印机策略设置为“无”或筛选不正确；客户端设备打印后台处理程序问题；Workspace 应用程序问题；客户端与 VDA 之间的网络连接问题；Citrix Print Manager Service (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 的 OU 上的 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 会话。

基本最终用户故障排除

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