银河麒麟桌面上USB打印机无法打印问题标准处理流程

USB打印机无法打印问题标准处理流程

目录

[一、 场景描述](#一、 场景描述)

[二、 适用范围](#二、 适用范围)

[三、 处理流程](#三、 处理流程)

[(一) 问题接收与信息收集](#(一) 问题接收与信息收集)

[(二) 安全备份](#(二) 安全备份)

[(三) 定位分析](#(三) 定位分析)

[1. 打印机硬件和链路故障排查](#1. 打印机硬件和链路故障排查)

[2. CUPS打印服务故障排查](#2. CUPS打印服务故障排查)

[3. 打印机驱动故障排查](#3. 打印机驱动故障排查)

[4. 软件故障排查](#4. 软件故障排查)

[5. CUPS日志排查](#5. CUPS日志排查)

[四、 注意事项](#四、 注意事项)

附:实际案例

  • 场景描述

银河麒麟桌面操作系统V10SP1连接USB打印机无法打印问题。从硬件、CUPS服务、驱动、软件等方面着手,结合CUPS日志确定根因。

  • 适用范围

·银河麒麟桌面操作系统 V10SP1全系列版本系统

·适用USB直连打印机打印的场景

  • 处理流程
    • 问题接收与信息收集

为快速精准定位问题,优先收集以下核心信息,明确故障基本特征:

1.系统版本

2.系统架构

3.打印机型号

4.最后一次正常打印时间

5.故障现象:打印无响应、打印报错、打印空白、打印乱码等。

6.故障范围:单个文档还是所有文档、单个软件还是多个软件、单台终端还是多台终端、单台打印机还是多台同型号打印机。

7.故障前变动:是否安装或更新软件、是否变更了配置。

8.命令收集关键信息:

|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1.查看已配置打印机信息: sudo grep -aiE 'printer|makemodel|deviceuri' /etc/cups/printers.conf 2.查看CUPS服务识别到的打印机信息: lpinfo -v 3.查看usb设备信息: lsusb 4.查看CUPS服务状态: systemctl status cups |

9.命令收集CUPS关键日志

|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1.开启cups的debug调试信息: sudo cupsctl --debug-logging 2.开启debug调试后打印一次,再查看打印任务日志: grep -aiE '\job \[0-9*\]' /var/log/cups/error_log 3.关闭cups的debug调试信息(信息收集后必须还原配置,关闭debug调试): sudo cupsctl --no-debug-logging |

    • 安全备份

遵守变更前需备份,调试配置需还原,操作可回滚的原则。

    • 定位分析
      1. 打印机硬件和链路故障排查

1.1打印机设备状态检查

1)检查打印机电源状态,确认设备正常通电开机。

2)查看打印机面板指示灯,无红灯告警、报错代码、缺纸、缺墨/碳粉、卡纸等硬件异常提示。

1.2物理连接链路检查

前提条件:打印机正常运行。

检查USB打印线两端接口,重新插拔终端USB口与打印机接口,更换USB接口、更换打印线测试,排除接口松动、线材损坏、接口故障问题。

|------------------------------------------------------------------------------------------------------------------------------------------|
| 1.插上usb数据线,执行命令,若没有识别到打印机,表示链路没通,需查看打印机线和接口: lsusb # 命令正常关键输出如下: # Bus 007 Device 004: ID 2a5c:6210 CLORD M540 # 如果显示了对应打印机,则表示系统能识别打印机。 |

1.3对比排查

将打印机接入其他电脑进行打印,如果可以打印,则可以确定硬件没

题。

解决方案:处理打印机卡纸、缺墨缺纸等问题,更换损坏数据线、故障USB接口,硬件损坏则送修设备,硬件恢复后重新测试打印功能。

      1. CUPS打印服务故障排查

CUPS(Common UNIX Printing System)是麒麟桌面系统底层核心打印服务,所有打印任务均依赖CUPS服务调度执行,服务停止、异常、配置错误会导致全局打印失效。

2.1 CUPS服务状态检查

|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1.查看服务运行状态: systemctl status cups # 命令正常关键输出如下: # Active: active (running) since Tue 2026-08-11 16:00:31 CST # 服务状态是active (running)是正常状态;如果服务状态存在dead、failed、stop、exited等,则是存在异常。 |

2.2 服务启停与自启配置

|---------------------------------------------------------------------------------------------------------------------------------------|
| 1.若服务未启动,则启动CUPS服务: sudo systemctl start cups 2.若服务没自启,设置开机自启: sudo systemctl enable cups 3.若服务异常,重启异常服务: sudo systemctl restart cups |

2.3CUPS包状态确认

|------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1.检查CUPS包状态是否正常: dpkg -l | grep cups # 命令正常关键输出如下: # ii cups 2.3.1-9kylin1.2k8.9 arm64 # 若cups包状态不是ii(正常)或者不存在,重装CUPS包: sudo apt install cups --reinstall |

2.4服务关键文件排查

|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1.查看配置文件: cat /etc/cups/cupsd.conf # 若配置文件损坏、缺失、内容不对,备份配置后恢复系统默认配置: sudo cp /etc/cups/cupsd.conf /etc/cups/cupsd.conf_bak sudo cp /usr/share/cups/cupsd.conf.default /etc/cups/cupsd.conf 2.查看执行文件权限: ls -l /usr/sbin/cupsd # 若执行文件权限不是755,更改权限: sudo chmod 755 /usr/sbin/cupsd |

2.5服务端口与进程排查

|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1.CUPS默认端口是631,检查端口占用状态: sudo netstat -anp | grep 631 # 命令正常关键输出如下: # tcp 0 0 127.0.0.1:631 0.0.0.0:* LISTEN 806/cupsd # 631端口被其他程序占用或端口未监听,都会导致服务无法正常提供打印调度服务。 (1)若端口被其他程序占用,则联系程序厂商,沟通处理。 (2)若端口未监听,则查看服务是否正常启动。 2.浏览器访问http://localhost:631地址,检查端口连通性: (1)若能打开cups网页,则CUPS端口访问正常。 (2)若不能打开cups网页,则排查CUPS的端口和服务状态。 |

2.6日志分析

|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1.实时查看CUPS服务日志,结合上述的方法确定根因,解决问题: journalctl -u cups -f (1)若cupsd.conf文件内容不对,则日志关键输出如下: # cupsd34608: Unable to read "/etc/cups/cupsd.conf" due to errors. (2)若cupsd.conf文件缺失,则日志关键输出如下: # cupsd40075: Unable to open "/etc/cups/cupsd.conf" - No such file or directory (3)若cupsd文件权限异常,则日志关键输出如下: # systemd64115: cups.service: Failed at step EXEC spawning /usr/sbin/cupsd: Permission denied |

解决方案:重启CUPS服务并配置开机自启,修复或还原相关文件,释放631冲突端口,重启服务后重新加载打印设备。

      1. 打印机驱动故障排查

打印机驱动缺失、版本不匹配、损坏、适配异常,会导致打印乱码、打印空白、打印部分功能缺失、打印无反应等问题。打印机型号、驱动包、使用驱动需要对应上。

3.1打印机信息获取

|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1.查看已配置打印机信息: sudo grep -aiE 'printer|makemodel|deviceuri' /etc/cups/printers.conf # 命令正常关键输出如下: # <DefaultPrinter CLORD-M540> # MakeModel clord adspseries, driver2.0.5 # DeviceURI usb://CLORD/M540?serial=M540_01234567 2.查看CUPS服务识别到的打印机信息: lpinfo -v # 命令正常关键输出如下: # direct usb://CLORD/M540?serial=M540_01234567 |

快速获取已配置打印机型号、URI和所用驱动名,以及CUPS识别到的打印机型号和URI。若实际打印机型号、CUPS识别到打印机URI和已配置打印机URI不一致,则排查打印机是否配置错误,重新配置。驱动名用于后续问题进一步排查。

3.2标准打印方案获取

获取标准打印适配方案作为主要参考,用于后续对比实际用的驱动包名和驱动名,进行排查。

|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1.去麒麟软件生态网站查找驱动包: 生态兼容清单-麒麟软件-国产操作系统 2.在打印机厂商的官网支持页面中查找驱动包: 3.打印机解决方案库表格: https://www.kdocs.cn/l/cnZetfCi0VMY 4.在银河麒麟的本地驱动库中查找驱动包: (1)在本地数据库中选择对应品牌、型号的驱动使用。 (2)也可以尝试generic通用的PostScript和PCL6等驱动。 |

3.3驱动包排查

前提条件:已查询到打印机对应的驱动。

以Pantum驱动为例,排查驱动包的状态和适配性。

|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1.查询包状态: dpkg -l | grep pantum # 命令正常关键输出如下: # ii pantum 8.1.1c147.2-1+kl10 arm64 (1)若pantum包状态不是ii(正常)或者不存在,重装Pantum包: sudo apt install pantum --reinstall (2)若pantum版本不对,安装对应版本驱动: # 例如奔图P3405DN只能用5.27版本驱动,安装离线包: sudo dpkg -i pantum_5.27kord3sp2_1_arm64.deb |

3.4驱动选择

部分驱动是开源兼容驱动,安装驱动包后不会自动选择正常驱动,需要手动去选择对应型号的驱动。

(1)打印方案已明确驱动名的:在本地数据库中选择对应品牌、相同型号的驱动使用。

(2)打印方案只明确驱动包,没明确驱动名的:在本地数据库中选择对应品牌、相同或相近型号的驱动使用;也可以查看该驱动包新增了什么PPD驱动文件,选择新增驱动。

|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1.以pantum驱动举例,在已安装pantum驱动的系统执行命令: sudo dpkg -L pantum |grep -i ppd # 命令正常关键输出如下: # /usr/share/cups/model/pantum/Pantum_BP5150DN_Series_PCL.ppd # /usr/share/cups/model/pantum/Pantum_P2505-S_Series.ppd # 驱动包中有很多PPD驱动文件,添加打印机时选择相同或相近型号的驱动使用。 2.个别驱动在添加打印机时选择驱动时显示的名字,和所用PPD文件名不一致,需要查看PPD里面的manufacturer和product值,以ffkyprint驱动为例。 (1)在已安装ffkyprint驱动的系统执行命令: sudo dpkg -L ffkylinprint | grep -i ppd # 命令正常关键输出如下: # /usr/share/cups/model/fujifilm/ffkylinprint.ppd (2)只有这个ffkylinprint.ppd驱动文件,查看该文件的信息 grep -aiE 'manufacturer|product' /usr/share/cups/model/fujifilm/ffkylinprint.ppd # 命令正常关键输出如下: # *Manufacturer: "FUJIFILM" # *Product: "(PDF Print Driver for Kylin)" # Manufacturer对应图形选择驱动时的"品牌",Product对应图形选择驱动时的"驱动" |

(3)没有打印方案的都可以尝试generic通用的PostScript和PCL6等驱动。

解决方案:标准打印适配方案作为主要参考,卸载不兼容、损坏驱动,安装对应型号适配的驱动包,选择正确的驱动,重新配置打印机参数,重启电脑和打印机后测试。

      1. 软件故障排查

前提条件:打印机驱动已经是最优的配置。

因为不同的驱动可能都支持基本打印,但一些高级功能不同,软件的兼容性也不同。保证打印机驱动已经是最优配置,通过其他方法侧面去解决。

4.1办公软件排查

部分驱动和办公软件兼容性不好。比如永中无法打印,但WPS可以打印。

(1)通过升级办公软件解决。

(2)使用其他办公软件打印。

4.2打印内容排查

文档的编码、文件名、特殊字符和特殊格式等内容会影响个别打印机打印。

(1)新建文档,复制内容到新文档,粘贴时选择只保留文本,保存后打印,看是否是编码、特殊字符和特殊格式影响。

(2)如果文件名目录很深且文件名很长,可以将文件放到桌面或者将文件名改短打印,看是否是文件名过长影响。

(3)如果文档内容很复杂,可以把它转成PDF或者图片打印。

4.3安全软件排查

检查安全、审计类软件(如奇安信杀毒软件、天融信、北信源主机审计等)的安全策略,它们有的会拦截打印任务或者影响打印程序。

(1)通过退出或者卸载安全软件后尝试打印。

(2)查看/var/log/cups/error_log日志,看打印过程是否有第三方软件影响。以安恒办公智盾为例:

|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1.开启CUPS的debug调试信息 sudo cupsctl --debug-logging 2.查看所有打印任务全流程,发现过滤器Filters存在报错,非系统自带文件watermarkfilter参与了打印过程: grep -iE '\job \[0-9*\]' /var/log/cups/error_log # 命令关键输出如下: # D Job 23 PID 17623 (/usr/lib/cups/filter/watermarkfilter) stopped with status 1. # E Job 23 Job stopped due to filter errors; please consult the /var/log/cups/error_log file for details. 3.正常打印的电脑没有该文件,将watermarkfilter改名后打印正常: sudo cp /usr/lib/cups/filter/watermarkfilter /usr/lib/cups/filter/watermarkfilter_bak 4.排查结束,关闭CUPS的debug调试信息 sudo cupsctl --no-debug-logging 5.排查发现是安恒办公智盾更新版本引入,由办公智盾更新版本解决。 |

解决方案:升级或更换办公软件、替换打印内容、文件改名、卸载安全软件并删除其引入的文件后测试。

      1. CUPS日志排查

CUPS是银河麒麟桌面系统底层核心打印服务,它的日志会记录打印的完整流程,方便定位问题出在哪块,日志的细节内容也有助于分析问题根因。

5.1打印流程概述

打印任务从发出到完成,通常需要经过几个步骤:

(1)前端 (Frontend):用来发起打印的程序,如记事本、WPS等。

(2)队列 (Queue):打印任务被放入一个队列中等待处理。

(3)过滤器 (Filters):将文档(如PDF、图片)转换成打印机能理解的语言(如PostScript、PCL)。

(4)后端 (Backend):将转换好的数据,通过特定的接口(如USB、网络)发送给打印机。

5.2打印日志收集

|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1.开启CUPS的debug调试信息: sudo cupsctl --debug-logging 2.开启debug调试后打印一次,再初步查看打印任务日志: grep -aiE '\job \[0-9*\]' /var/log/cups/error_log 3.关闭CUPS的debug调试信息(信息收集后必须还原配置,关闭debug调试): sudo cupsctl --no-debug-logging 4.必要情况下需要将/var/log/cups/error_log整个日志文件拷贝出来。 |

5.3日志案例简单分析

了解打印基本流程,重点看E报错前后相关日志。

|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1.过滤器(Filters): (1)过滤器Filters存在报错,非系统自带文件watermarkfilter参与了打印过程。正常打印电脑没有该文件,将watermarkfilter改名后打印正常。 # D Job 23 PID 17623 (/usr/lib/cups/filter/watermarkfilter) stopped with status 1. # E Job 23 Job stopped due to filter errors; please consult the /var/log/cups/error_log file for details. (2)过滤器Filters存在报错,提示无法启动rastertoclordadsps过滤器,该过滤器是打印机驱动提供,重装打印机驱动后打印正常。 # I Job 12 Started filter /usr/lib/cups/filter/pdftopdf (PID 263420) # I Job 12 Started filter /usr/lib/cups/filter/gstoraster (PID 263421) # E Job 12 Unable to start filter "rastertoclordadsps" # E Job 12 Stopping job because the scheduler could not execute a filter. 2.后端(Backend) (1)后端backend存在报错,更换打印机线后打印正常。 # E Job 82 无法向打印机发送数据。 # D Job 82 libusb write operation returned ffffffff.(libusb写入报ffffffff异常) # D Job 82 Sent 106496 bytes...(已发送了106496字节才报错,表示链路不稳定) # D Job 82 Waiting for read thread to exit...(libusb后端采用读写双线程,写线程下发打印数据,读线程接受打印机状态响应。写线程报错后,主线程等待读线程正常退出。) # D Job 82 Read thread still active, aborting the pending read...(等待几秒后读线程无法正常退出,强制终止。) # D Job 82 PID 104756 (/usr/lib/cups/backend/usb) stopped with status 1.(libusb后端进程退出) |

解决方案:收集并分析打印日志,重点关注报错在打印流程哪个阶段,结合定位分析过程中的1-4小节的内容点,从硬件、CUPS服务、驱动、软件等四个方面去解决问题。

  • 注意事项

1.所有服务、配置、驱动修改前需备份原始配置或者记录,确保操作可回滚,避免误操作导致故障扩大。

2.故障修复后需多次测试不同文档、不同格式文件打印,验证功能稳定性,避免问题复发。

3.所有故障处理完成后做好复盘记录,沉淀问题根因与解决方案,完善运维经验。

附:实际案例

一、问题描述

大量打印机原本打印功能正常,自某一时间节点后陆续出现横版打印异常或完全无法打印等问题。

二、问题分析过程

1.从硬件、CUPS服务、驱动等方面排查,都没有发现异常。

2.了解到办公智盾在这个时间段有推送更新,尝试退出和卸载办公智盾后,一部分恢复正常,一部分还是异常。

3.执行以下命令,查看所有打印任务的完整执行流程,发现问题机器的CUPS日志中都存在过滤器 (Filters)报错。

|----------------------------------------------------------|
| grep -iE '\Job \[0-9*\]' /var/log/cups/error_log |

日志关键输出如下:

|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| D Job 23 /usr/lib/cups/filter/watermarkfilter: 第 31 行:cd: /opt/apps/com.dbappsecurity.ues/files/wmt: 没有那个文件或目录 D Job 23 PID 17623 (/usr/lib/cups/filter/watermarkfilter) stopped with status 1. D Job 23 PID 17622 (/usr/lib/cups/filter/bannertopdf) did not catch or ignore signal 13. D Job 23 PID 17625 (/usr/lib/cups/backend/usb) exited with no errors. E Job 23 Job stopped due to filter errors; please consult the /var/log/cups/error_log file for details. D Job 23 printer-state-message="Filter failed" |

4.从日志里发现/usr/lib/cups/filter/watermarkfilter文件参与了打印。在打印正常的系统里执行以下命令,发现watermarkfilter文件不存在。推测该文件是由办公智盾引入,影响打印。

|-----------------------------------------|
| ls /usr/lib/cups/filter/watermarkfilter |

5.备份并删除watermarkfilter文件,并重启系统和打印机后,打印恢复正常。

|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| sudo mv /usr/lib/cups/filter/watermarkfilter /usr/lib/cups/filter/watermarkfilter-bak sudo rm /usr/lib/cups/filter/watermarkfilter 【危险】 此命令将不可逆删除指定文件或目录及其所有内容!执行前请确保路径正确,避免误删系统关键目录(如 "/"、"/home")。 |

6.了解到办公智盾水印追溯模块在故障节点时间更新到了10.25.21.20版本。经软件厂家确认,watermarkfilter文件由该软件引入且会影响打印。卸载办公智盾,部分会残留watermarkfilter文件影响打印。后续办公智盾发布了10.25.21.21版本,通过办公智盾服务端推送到客户端自动更新,解决了该问题。

三、问题解决办法

临时解决办法:

1.执行以下命令,删除watermarkfilter文件:

|---------------------------------------------------------------------------------------------------------------|
| sudo rm /usr/lib/cups/filter/watermarkfilter 【危险】此命令将不可逆删除指定文件或目录及其所有内容!执行前请确保路径正确,避免误删系统关键目录(如 "/"、"/home")。 |

2.重启系统和打印机即可。

永久解决办法:

办公智盾服务端推送办公智盾水印追溯模块10.25.21.21版本,客户端自动更新后重启系统和打印机即可。

相关推荐
Decay__36 分钟前
附 - 02・SQLServer 分库分表与中间件 —— 原生分区表、横向分库实践与联邦查询
运维·数据库·sql·mysql·架构
15Moonlight1 小时前
Linux 网络(11):IO 多路转接(select /poll/epoll)
linux·网络
wno7042 小时前
CentOS下FTP服务搭建
linux·运维·centos
mylove_北极甜虾2 小时前
jenkins-01Jenkins 架构与任务调度
运维·jenkins
15Moonlight2 小时前
Linux网络(12):Reactor 模式
linux·网络
张小姐的猫3 小时前
【基于 WebSocket 的多用户网页五子棋】—— 整合封装服务器模块设计实现1️⃣
服务器·websocket·网络协议
思想觉悟4 小时前
Android启动流程之点rc文件
android·linux·面试
kyle~15 小时前
嵌入式 SoC 系统
linux·c++·嵌入式·计算系统
tianyuanwo16 小时前
PostgreSQL 部署运维实战总结:从安装踩坑到生产可用
运维·数据库·postgresql