CUPS状态显示“打印机离线”如何解决？

Question

问题：CUPS 状态显示“打印机离线”，但设备已通电且连接正常，如何排查解决？ 当 CUPS（Common Unix Printing System）管理界面显示打印机“离线”时，常见原因包括打印队列卡死、后端服务异常、USB/网络连接不稳定或打印机自身状态未同步。首先检查物理连接与电源，确认打印机就绪；其次通过 `lpstat -p` 查看打印机状态，使用 `sudo cups restart` 重启服务；若为网络打印机，验证 IP 连通性与端口（通常 631）是否开放；还可尝试删除并重新添加打印机。此外，查看 `/var/log/cups/error_log` 日志有助于定位具体错误。

Answer 1

一、基础排查：从物理层到服务状态检查

当 CUPS 状态显示“打印机离线”，但设备已通电且连接正常时，首先应确认最基础的物理与网络条件是否满足。尽管问题表象在软件层面，底层硬件或链路异常仍可能是根源。

• 确认打印机电源开启，面板无错误提示（如卡纸、缺墨等）。
• 对于 USB 打印机，检查 USB 线缆是否插紧，尝试更换端口或线材。
• 对于网络打印机，使用 ping <打印机IP> 测试连通性。
• 执行 lpstat -p 查看 CUPS 中打印机的实际状态：

$ lpstat -p
printer HP_LaserJet is not accepting requests
printer HP_LaserJet disabled since Jan 01 10:00 - 
"Reason: Paused, Filter failed"

若输出中包含 "disabled" 或 "not accepting requests"，说明队列被暂停或后端处理失败。

接着重启 CUPS 服务以恢复可能卡死的进程：

sudo systemctl restart cups

部分系统中命令为 sudo service cups restart，需根据发行版调整。

二、中级诊断：日志分析与协议通信验证

在完成基础检查后，进入日志驱动的深度排查阶段。CUPS 的日志文件是定位问题的核心资源，尤其适用于间歇性“离线”故障。

日志路径	用途说明
/var/log/cups/error_log	记录后端错误、连接超时、认证失败等关键事件
/var/log/cups/access_log	追踪 HTTP 请求行为，可用于判断是否收到打印任务
/var/log/cups/page_log	记录每页打印详情，用于作业完成状态审计

查看最近的日志条目：

sudo tail -f /var/log/cups/error_log | grep -i "error\|offline"

常见错误包括：

• Unable to connect to printer-host:631: Connection refused
• Backend failed with status code 1
• Device busy or not responding

若发现连接拒绝，进一步使用 nc 或 nmap 检查目标端口（通常为 631）：

nc -zv <打印机IP> 631

三、高级修复：配置重建与后端机制剖析

当常规手段无效时，需深入理解 CUPS 架构中的后端（backend）机制。CUPS 使用不同的后端程序处理不同类型的连接（如 usb:, socket:, http:），其执行失败会导致“离线”误报。

可通过以下命令列出当前可用的后端：

ls /usr/lib/cups/backend/

确保对应协议的后端可执行（如 socket 对应网络打印机）。

若怀疑配置损坏，建议删除并重新添加打印机。使用命令行方式更可控：

lpadmin -x HP_LaserJet
lpadmin -p HP_LaserJet -E -v socket://192.168.1.100 -m everywhere
cupsenable HP_LaserJet
cupsaccept HP_LaserJet

其中 -m everywhere 启用 AirPrint 驱动自动探测功能，在现代 Linux 发行版中兼容性更好。

四、流程图：CUPS 打印机离线问题排查决策树

graph TD A[打印机显示离线] --> B{物理连接正常?} B -- 是 --> C[运行 lpstat -p] B -- 否 --> D[检查电源/USB/网线] C --> E{状态为 paused/disabled?} E -- 是 --> F[执行 cupsenable 和 cupsaccept] E -- 否 --> G[重启 CUPS 服务] G --> H[检查 /var/log/cups/error_log] H --> I{存在连接错误?} I -- 是 --> J[测试 631 端口连通性] I -- 否 --> K[重置打印机配置] J --> L{端口不通?} L -- 是 --> M[检查防火墙/打印机网络设置] L -- 否 --> N[尝试重新添加打印机] K --> N N --> O[验证打印测试页]

五、扩展思考：自动化监控与企业级部署建议

在大规模 IT 环境中，手动排查效率低下。建议构建基于脚本的健康检查机制：

#!/bin/bash
PRINTER="HP_LaserJet"
if ! lpstat -p "$PRINTER" | grep -q "ready"; then
    echo "[$(date)] Printer $PRINTER offline, restarting CUPS..." >> /var/log/printer_monitor.log
    systemctl restart cups
    sleep 5
    if ! lpstat -p "$PRINTER" | grep -q "ready"; then
        # 可集成邮件告警或调用 API 通知运维平台
        curl -X POST https://api.monitoring.local/alert \
             -d "Printer $PRINTER remains offline after CUPS restart"
    fi
fi

此外，在 Active Directory 集成环境中，注意 SELinux 或 AppArmor 策略可能阻止 CUPS 访问网络资源，需通过 setsebool -P lp_can_network=1 开启相关权限。