1 基础信息

• a. 问题分类：打印机操作与配置故障
• b. 适配系统：通用
• c. 硬件架构：通用

2 关键字

HP M126、HP M128、USB直连、打印不稳定、麒麟系统、hplip、cups

3 故障现象

HP LaserJet Pro MFP M126、M128系列打印机采用USB直连方式接入主机时，打印任务执行不稳定，打印作业经常无法正常输出，需要重启打印机设备之后才可以恢复打印功能。

4 根因分析

该故障由打印机固件本身缺陷导致：在USB通信模式下，主机读取打印机设备状态流程异常，造成CUPS打印服务无法正确识别设备状态，进而出现打印任务卡住、不输出的现象。

5 修复操作步骤

通过更新HPLIP驱动，并配置CUPS的USB兼容quirks参数规避固件缺陷，完整操作流程如下：

• 步骤1：安装最新版本 hplip 打印驱动组件

$ sudo apt install hplip

• 步骤2：获取打印机USB设备 VID、PID 标识并记录

$ lsusb

步骤3：编辑CUPS的USB quirks配置文件，写入对应打印机兼容参数。下面以 HP LaserJet Pro MFP m126a（VID:03f0，PID:222a）作为示例。

配置文件路径：/usr/share/cups/usb/hp.hplip.usb‑quirks

# HP LaserJet Pro MFP m126a 0x03f0 0x222a no‑reattach soft‑reset

使用vim命令编辑该文件，将上面一行配置追加至文件末尾后保存退出。

• 步骤4：重载重启 CUPS 打印服务，使配置生效

$ sudo systemctl restart cups

• 步骤5：物理重启打印机设备，完成全部修复流程。

6 共享打印场景补充说明

若该打印机作为共享设备使用：USB直连打印机的服务端主机必须执行上述全套配置；通过网络添加该共享打印机的客户端机器，无需做任何quirks配置。

7 兼容性验证环境

该修复方案已在以下麒麟操作系统环境完成验证测试：

系统镜像名称	CPU芯片	系统版本	HPLIP版本	打印机型号	VID	PID
Kylin‑Desktop‑V10‑SP1‑General‑Release‑OEM‑R‑THTF‑MF20A‑d‑ 20220127‑arm64	飞腾	V10SP1	hplip_3.23.5.2_arm64.deb	HP Laser Jet Pro MFP M126a	03f0	222a
Kylin‑Desktop‑V10‑SP1‑2303‑update1‑Wayland‑Release‑General‑ kirin990‑20230703‑ARM64	990	V10SP1	hplip_3.23.5.2_arm64.deb	HP Laser Jet Pro MFP M126a	03f0	222a
Kylin‑Desktop‑V10‑SP1‑General‑Release‑2303‑ARM64	飞腾	V10SP1	hplip_3.23.5.2_arm64.deb	HP Laser Jet Pro MFP M126a	03f0	222a
Kylin‑Desktop‑V10‑SP1‑General‑Release‑OEM‑KT‑M740Z‑211231‑ arm64	飞腾	V10SP1	hplip_3.24.7.2_arm64.deb	HP Laser Jet Pro MFP M126a	03f0	222a
Kylin‑Desktop‑V10‑SP1‑2403‑Release‑20240506‑loongarch64	loongarch64	V10SP1	hplip_3.23.5.2_loongarch64.deb	HP Laser Jet Pro MFP M128fn	03f0	322a
Kylin‑Desktop‑V10‑Release‑Build1‑20200710‑arm64	飞腾	V10	hplip_3.23.5.2_arm64.deb	HP Laser Jet Pro MFP M128fp	03f0	322a