产品文档
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
查看 PDF

故障排除

April 8, 2026
投稿者: 
C C

系统化方法

在复杂的 Citrix Virtual Apps and Desktops™ (CVAD) 环境中排查打印问题需要系统化的方法，而非随意猜测。建议的流程包括：

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

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

-  **无法自动创建打印机 / 打印机未在会话中显示：**

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

-  **打印后台处理程序崩溃 / 服务无响应（在 VDA 或打印服务器上）：**

-  **潜在原因：** 故障或不兼容的打印机驱动程序（通常是第三方）；队列中损坏的打印作业；驱动程序冲突；系统资源不足。

-  **故障排除步骤：**

    1.  使用 Windows 事件日志识别故障进程/模块（应用程序日志通常显示后台处理程序崩溃）。
    1.  尝试重新启动打印后台处理程序服务。
    1.  如果重新启动失败或问题重复出现，请尝试手动清除打印队列（停止后台处理程序服务，删除 C:\Windows\System32\spool\PRINTERS 中的文件，启动后台处理程序服务）。
    1.  识别并删除有问题的打印机驱动程序。彻底删除可能需要编辑注册表。
-  1.  使用 Citrix UPD 或通用 Microsoft 驱动程序进行测试。
-  1.  检查并清理注册表中的孤立打印处理器。

-  **策略冲突 / 设置被忽略：**

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

-  **故障排除步骤：**

    1.  使用 Citrix 组策略建模向导模拟受影响用户/VDA 的策略应用。
-  1.  验证策略筛选器（用户组、客户端 IP 等）是否正确。
-  1.  在 Studio/Web Studio 中检查策略优先级。
-  1.  暂时阻止 VDA 的 OU 上的 GPO 继承，以隔离 Citrix 策略问题。
    1.  检查 VDA 上的策略处理结果（例如，使用 gpresult /h report.html）。
    1.  简化应用于用户/VDA 的策略集，并逐步添加策略以查找冲突。

-  **驱动程序问题（一般 - 兼容性、损坏、映射）：**

-  **潜在原因：** 驱动程序与 VDA 操作系统或 Citrix 版本不兼容；驱动程序安装损坏；策略所需的驱动程序在 VDA 上缺失；多个驱动程序之间存在冲突；打印机驱动程序映射策略配置不正确。
-  **故障排除步骤：**
-  1.  尝试使用 Citrix UPD 打印（配置通用打印驱动程序使用策略）。
-  1.  验证是否根据应用的策略选择了正确的驱动程序（本机或 UPD）。
-  1.  确保所需的本机驱动程序已正确安装在 VDA 上（如果使用）。
    1.  查阅供应商文档，了解驱动程序与 CVAD 和 VDA 操作系统版本的兼容性。
    1.  彻底重新安装有问题的驱动程序（卸载、重启、安装）。
    1.  仔细审查并测试打印机驱动程序映射策略规则。
    1.  尽量减少 VDA 上安装的驱动程序数量。
  • 打印速度慢/性能问题：
    • 潜在原因： 网络拥堵或高延迟（尤其是 WAN）；大型、复杂的打印作业（例如，高分辨率图形）；低效的打印机驱动程序；打印优化（压缩、缓存）已禁用或配置错误；路由效率低下（例如，通过慢速 WAN 的直接连接）。
    • 故障排除步骤：
    1. 分析 VDA、客户端和打印服务器之间的网络路径和性能。
        1. 配置 Citrix 打印带宽限制策略。
        1. 通过通用打印策略启用并配置 UPD 优化（图像压缩、字体/图像缓存）。
      1. 对于 WAN 链接，禁用“直接连接到打印服务器”策略，以强制流量通过压缩的 ICA® 通道。
      2. 如果使用 UPS，请确保其已针对网络进行优化配置。
      3. 分析打印作业本身 – 如果可能，降低分辨率或复杂性。
      4. 使用不同的驱动程序进行测试（例如，UPD 与本机驱动程序）。
  • 输出不正确（字符缺失、格式错误、方向错误）：
    • 潜在原因： VDA 上缺少文档/应用程序所需的字体；字体替换不正确；打印机驱动程序不兼容；特定 UPD 格式（例如 EMF 与 XPS）的问题；应用程序错误；与本地客户端打印机上启用的高级打印功能冲突。
    • 故障排除步骤：
      1. 确保 VDA 上安装了所有必需的字体。
      2. 尝试更改通用驱动程序首选项策略顺序（例如，先尝试 XPS，再尝试 EMF）。
      3. 尝试从不同的应用程序打印同一文档。
      4. 尝试打印到不同的物理打印机或虚拟打印机（例如，Microsoft XPS 文档写入器）。
      5. 尝试使用不同的打印机驱动程序（UPD 与本机驱动程序，或不同的本机版本）。
      6. 检查应用程序的打印设置和页面设置。
      7. 在客户端设备上的本地打印机属性中禁用“高级打印功能”。
    1. 验证用户首选项和策略中的打印方向设置。
  • Citrix Print Manager Service (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™ 会话并重新登录。
  • 检查端点设备上本地打印机的状态（确保其在线、未暂停、无错误）。
  • 重启本地端点设备。
故障排除
April 8, 2026
投稿者: 
C C
April 8, 2026
投稿者: 
C C

在本文中

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