You need to enable JavaScript to run this app. Debian 10下Python通过CUPS打印图片报「页面设置无效」报错咨询
优惠活动
大模型
产品
解决方案
定价
更多

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的页面尺寸校验规则

修复操作可按以下步骤执行:

  1. 先通过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]
    
  2. 提交作业时显式匹配打印机参数,不要留空的选项字典
    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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.30 19:54:04