Debian 10下Python通过CUPS打印图片报「页面设置无效」报错咨询
Debian 10 下CUPS Python图片打印问题排查与实现
现有场景
在Debian 10系统使用Python cups库编写图片打印脚本,原始实现代码如下:
import cups def printImageLinux(image_name): conn = cups.Connection() printer = conn.getDefault() conn.printFile(printer, image_name, 'suo_ticket', {})
执行后打印任务进入队列即被自动取消,访问本地CUPS管理界面(localhost:631)可看到报错:The page setup information was not valid.
目前已在Windows环境通过win32print配合PIL库,实现了图片自动等比适配、居中打印的正常逻辑,对应的Windows端可运行代码如下:
import os, sys from win32 import win32api, win32print from PIL import Image, ImageWin import win32ui def printImage(image_name): # GetDeviceCaps 设备参数常量定义 HORZRES = 8 VERTRES = 10 LOGPIXELSX = 88 LOGPIXELSY = 90 PHYSICALWIDTH = 110 PHYSICALHEIGHT = 111 PHYSICALOFFSETX = 112 PHYSICALOFFSETY = 113 printer_name = win32print.GetDefaultPrinter() file_name = image_name # 创建打印机设备上下文,获取纸张打印参数 hDC = win32ui.CreateDC() hDC.CreatePrinterDC(printer_name) printable_area = hDC.GetDeviceCaps(HORZRES), hDC.GetDeviceCaps(VERTRES) printer_size = hDC.GetDeviceCaps(PHYSICALWIDTH), hDC.GetDeviceCaps(PHYSICALHEIGHT) printer_margins = hDC.GetDeviceCaps(PHYSICALOFFSETX), hDC.GetDeviceCaps(PHYSICALOFFSETY) # 打开图片,宽大于高时旋转90度,计算等比缩放比例 bmp = Image.open(file_name) if bmp.size[0] > bmp.size[1]: bmp = bmp.rotate(90) ratios = [1.0 * printable_area[0] / bmp.size[0], 1.0 * printable_area[1] / bmp.size[1]] scale = min(ratios) # 启动打印任务,按缩放尺寸居中绘制图片 hDC.StartDoc(file_name) hDC.StartPage() dib = ImageWin.Dib(bmp) scaled_width, scaled_height = [int(scale * i) for i in bmp.size] x1 = int((printer_size[0] - scaled_width) / 2) y1 = int((printer_size[1] - scaled_height) / 2) x2 = x1 + scaled_width y2 = y1 + scaled_height dib.draw(hDC.GetHandleOutput(), (x1, y1, x2, y2)) hDC.EndPage() hDC.EndDoc() hDC.DeleteDC()
待解决的两个核心问题:
- 如何修复Debian下CUPS提交打印任务时的页面设置无效报错
- 如何在Debian环境复现与Windows端完全一致的图片自适应适配、居中打印逻辑
报错修复方案
The page setup information was not valid报错的核心诱因有两点:
- 提交打印任务时未传递任何作业参数,CUPS无法匹配对应打印机的页面规格,直接触发参数校验失败
- 原始图片自带的分辨率、尺寸信息与打印机默认页面参数不匹配,触发了CUPS的页面尺寸校验规则
修复操作可按以下步骤执行:
- 先通过CUPS连接读取默认打印机的内置参数,无需手动硬编码纸张尺寸
conn = cups.Connection() printer_name = conn.getDefault() printer_attrs = conn.getPrinterAttributes(printer_name) # 提取默认页面规格 default_media = printer_attrs['media-default'] media_col = printer_attrs['media-col-default'] imaging_bbox = media_col['imaging-bbox'] # 可打印区域坐标[左,下,右,上] default_dpi = printer_attrs['printer-resolution-default'][0] - 提交作业时显式匹配打印机参数,不要留空的选项字典
job_options = { 'media': default_media, 'fit-to-page': 'true', # 开启CUPS内置的页面适配能力 'resolution': default_dpi } conn.printFile(printer_name, image_name, 'suo_ticket', job_options)
未传参数时,CUPS默认会按图片原始像素尺寸映射到打印页面,若图片尺寸远大于可打印区域,就会直接触发校验错误取消作业。
Debian端自适应打印实现
完全可以复现Windows端的打印逻辑,无需依赖Windows专属API,通过PIL配合CUPS参数读取即可实现和Windows端一致的处理流程:读取打印机可打印区域尺寸、宽图自动旋转、等比缩放不拉伸、图片居中放置。
可直接运行的完整实现代码:
import cups from PIL import Image def printImageLinux(image_name): conn = cups.Connection() printer_name = conn.getDefault() # 读取打印机默认参数 printer_attrs = conn.getPrinterAttributes(printer_name) media_col = printer_attrs['media-col-default'] imaging_bbox = media_col['imaging-bbox'] # 可打印区域尺寸,单位:PostScript点(1点=1/72英寸) printable_width_pt = imaging_bbox[2] - imaging_bbox[0] printable_height_pt = imaging_bbox[3] - imaging_bbox[1] # 提取打印机默认DPI dpi_str = printer_attrs['printer-resolution-default'][0] dpi = int(dpi_str.split('x')[0]) # 将点尺寸转换为对应DPI下的像素尺寸 printable_width_px = int(printable_width_pt / 72 * dpi) printable_height_px = int(printable_height_pt / 72 * dpi) # 图片预处理,逻辑与Windows端完全对齐 with Image.open(image_name) as img: # 宽大于高时自动旋转90度 if img.size[0] > img.size[1]: img = img.rotate(90, expand=True) # 计算等比缩放比例,保证图片不超出可打印区域 ratio_w = printable_width_px / img.size[0] ratio_h = printable_height_px / img.size[1] scale = min(ratio_w, ratio_h) new_width = int(img.size[0] * scale) new_height = int(img.size[1] * scale) resized_img = img.resize((new_width, new_height), Image.LANCZOS) # Debian10自带PIL版本兼容写法 # 构建和可打印区域同尺寸的白色画布,将缩放后的图片居中放置 canvas = Image.new('RGB', (printable_width_px, printable_height_px), 'white') paste_x = (printable_width_px - new_width) // 2 paste_y = (printable_height_px - new_height) // 2 canvas.paste(resized_img, (paste_x, paste_y)) # 保存临时图片,写入和打印机匹配的DPI信息 temp_img_path = '/tmp/cups_print_temp.png' canvas.save(temp_img_path, dpi=(dpi, dpi)) # 提交打印任务,传递匹配的页面参数 job_options = { 'media': printer_attrs['media-default'], 'resolution': dpi_str, # 由于已手动完成图片适配,关闭CUPS内置的重复缩放 'fit-to-page': 'false' } conn.printFile(printer_name, temp_img_path, 'suo_ticket', job_options)
注意事项
- 一定要将处理后图片的DPI信息设置为与打印机默认DPI匹配,否则CUPS会按默认DPI重新计算尺寸,可能再次触发页面校验错误
- Debian 10仓库自带的Pillow版本较老,直接使用
Image.LANCZOS即可,无需使用新版本的Image.Resampling枚举 - CUPS内置的图片过滤器可直接处理PNG格式,无需额外转成PDF格式
内容的提问来源于stack exchange,提问作者andrey.t
相关产品推荐
相关产品推荐

