树莓派使用Brother QL-800打印机调用brother-ql模块无报错不打印求助

基础硬件与系统连接校验 #

• 确认打印机物理状态：电源正常开启、标签纸/色带安装正确、无报错指示灯（缺纸、舱门未关等）闪烁
• 验证设备连通性：USB连接的设备运行lsusb命令查看是否有Brother QL系列打印机在设备列表中；网络连接的设备运行ping 打印机IP确认网络连通无丢包
• 执行brother_ql_info list命令，确认brother-ql模块可以正常识别到当前连接的打印机设备

打印参数配置校验 #

• 确认代码中指定的打印机型号与实际硬件完全一致，例如QL-800和QL-810W配置不通用，型号填写错误会出现静默不打印的情况
• 确认代码中设置的标签规格与实际安装耗材匹配：包括标签宽度、是否为连续纸、是否支持双色打印等参数，参数不匹配时打印机将拒绝执行任务
• 检查打印内容尺寸：brother-ql要求输入的图片像素尺寸必须与标签可打印区域的像素完全对应，尺寸不符合时也会出现无报错不执行的问题

权限与日志排查 #

• 开启brother-ql的调试日志输出，查看底层指令发送环节是否存在隐藏异常
• USB连接场景下尝试使用sudo运行Python代码，如果sudo后可正常打印，说明是用户权限不足，执行sudo usermod -aG lp $USER将当前用户加入lp用户组后重启即可解决
• 若设备同时安装了CUPS打印服务，可查看CUPS任务列表确认打印任务是否被拦截、是否存在任务报错记录

内容的提问来源于stack exchange，提问作者Dashi Nesh