Windows系统中qz.printers.clearQueue()函数无法正常工作的问题

问题场景 #

打印机离线时提交打印任务，为避免打印机恢复在线后自动执行，在任务进入打印阶段15秒未完成时尝试清除任务。记录jobId后调用以下代码：

qz.printers.clearQueue({
  printerName: "Bill",
  jobId: 19
});

Mac系统可正常取消任务，但Windows系统抛出错误：

Job# 19 is not part of the 'Bill' print queue

仅传入打印机名称尝试清空整个队列时无任何操作：

qz.printers.clearQueue({
  printerName: "Bill",
});

注：传入的printerName和jobId均为正确值

原因分析 #

Windows与Mac的打印队列机制存在核心差异：

• 打印机离线时，Windows会将待执行任务标记为"已暂停"，并转移至系统级的打印池队列，而非直接关联到目标打印机的队列中，导致qz-tray无法通过打印机名称匹配到该任务。
• qz-tray的clearQueue方法在Windows环境下，依赖任务与目标打印机的实时关联状态，离线状态下这种关联会被系统中断。

解决方案 #

1. 直接通过系统任务ID清除 #

qz返回的jobId可能与Windows系统内部的打印任务ID不一致，需通过系统API获取真实任务ID后删除。可以调用Windows的WMI接口执行操作：

const { exec } = require('child_process');
// 替换为系统真实任务ID
const systemJobId = 20; 
exec(`wmic printjob where JobId=${systemJobId} delete`, (err, stdout, stderr) => {
  if (err) {
    console.error('删除任务失败:', err);
    return;
  }
  console.log('任务已成功删除');
});

也可尝试在qz-tray中省略printerName，仅传入jobId（部分新版本支持此方式）：

qz.printers.clearQueue({
  jobId: 19
});

2. 清空系统全局打印池（谨慎使用） #

如果无需保留其他打印任务，可通过系统命令清空所有打印队列：

const { exec } = require('child_process');
exec('net stop spooler && del /Q /F /S "%systemroot%\\System32\\spool\\PRINTERS\\*" && net start spooler', (err, stdout, stderr) => {
  if (err) {
    console.error('清空队列失败:', err);
    return;
  }
  console.log('全局打印队列已清空');
});

3. 升级qz-tray并检查权限 #

部分旧版本qz-tray在Windows下对离线任务的处理存在bug，升级至最新稳定版可能解决问题。同时确保qz-tray以管理员身份运行，拥有访问系统打印队列的权限。

4. 提交任务时设置自动清除 #

在提交打印任务时添加removeAfterPrint: true配置，任务完成或失败后会自动从队列中移除，无需手动清除：

qz.print(config, [{
  type: 'plain',
  data: '打印内容',
  options: { removeAfterPrint: true }
}]);

内容的提问来源于stack exchange，提问作者Joon Shakya