Python调用标签打印机无响应问题排查求助

核心问题总结 #

你的代码运行无反应、不打印的原因主要集中在打印机配置错误无反馈、GUI线程阻塞、未处理异常以及冗余代码/重复API调用这几个点上，具体如下：

1. 硬编码打印机名称，无错误处理 #

你代码里写死了printer_name = 'Test Printer'，如果系统里没有这个名称的打印机，win32print.OpenPrinter会直接失败，但因为没有异常捕获，程序不会给出任何报错信息，直接静默终止打印流程。

解决办法：

• 先运行print(win32print.EnumPrinters(2))获取系统内所有打印机列表，替换成正确的打印机名称；
• 添加异常捕获块，在GUI里弹出错误提示，让你知道问题出在哪。

2. 打印操作阻塞GUI线程 #

print_labels方法在点击按钮后直接在GUI主线程里执行循环打印，如果打印次数多，整个GUI会卡死，看起来像是程序没反应。

解决办法：

• 使用threading模块把打印任务放到子线程里执行，避免阻塞主线程，保证GUI始终响应。

3. 重复调用Google Sheets API #

每次循环都重新获取sheet.get_all_values()和sheet.acell('F2').value，不仅速度慢，还会频繁触发API请求，可能触发Google的API限额限制。

解决办法：

• 提前一次性获取这些值并存在变量里，循环时直接使用，减少API调用次数。

4. 冗余的认证代码 #

代码开头已经完成了Google Sheets的认证和工作表打开，类定义之后又重复写了一遍完全相同的认证代码，属于冗余代码，删掉即可。

修复后的完整代码 #

import gspread
from oauth2client.service_account import ServiceAccountCredentials
import win32print
import tkinter as tk
from tkinter import messagebox
import threading

# 只做一次Google Sheets认证
creds = ServiceAccountCredentials.from_json_keyfile_name('creds.json', [
                                                         'https://spreadsheets.google.com/feeds', 'https://www.googleapis.com/auth/drive'])
client = gspread.authorize(creds)
sheet = client.open_by_key(
    '1eRO-30eIZamB5sjBp-Mz2QMKCfGxV037MQO8nS7G7AI').worksheet('Label')


class App(tk.Frame):
    def __init__(self, master=None):
        super().__init__(master)
        self.master = master
        self.master.title('Porter\'s Label Printer')
        self.master.geometry('400x300')
        self.counter = 0
        self.total_labels = self.get_total_labels()
        self.create_widgets()
        self.update_counter()

    def create_widgets(self):
        self.print_button = tk.Button(self.master, text='Print Labels', command=self.start_print_thread, font=(
            'Arial', 24), bg='lightblue', padx=40, pady=40)
        self.print_button.pack(fill=tk.BOTH, expand=True)

        self.counter_label = tk.Label(self.master, text='0 of {} labels printed'.format(
            self.total_labels), font=('Arial', 18))
        self.counter_label.pack(pady=20)

        self.refresh_button = tk.Button(self.master, text='Refresh', command=self.refresh_labels, font=(
            'Arial', 14), bg='lightgrey', padx=20, pady=10)
        self.refresh_button.pack(pady=20)

    def get_total_labels(self):
        """安全获取F2单元格的打印次数"""
        try:
            return int(sheet.acell('F2').value)
        except ValueError:
            messagebox.showerror("错误", "F2单元格的值不是有效整数")
            return 0

    def start_print_thread(self):
        """启动子线程执行打印，避免阻塞GUI"""
        if self.counter < self.total_labels:
            self.print_button.config(state=tk.DISABLED)
            threading.Thread(target=self.print_labels, daemon=True).start()

    def print_labels(self):
        printer_name = '你的实际打印机名称'  # 替换成你系统内的正确打印机名称
        # 提前获取打印数据，避免重复API调用
        print_data = sheet.get_all_values()
        print_data_str = '\n'.join(['\t'.join(row) for row in print_data])
        remaining = self.total_labels - self.counter

        for _ in range(remaining):
            try:
                printer_handle = win32print.OpenPrinter(printer_name)
                job_info = ("Label", None, "RAW")
                win32print.StartDocPrinter(printer_handle, 1, job_info)
                win32print.WritePrinter(printer_handle, print_data_str.encode('utf-8'))
                win32print.EndDocPrinter(printer_handle)
                win32print.ClosePrinter(printer_handle)
                
                # 必须在GUI线程更新计数器
                self.master.after(0, self.update_counter_in_gui)
            except Exception as e:
                # 在GUI线程弹出错误提示
                self.master.after(0, lambda: messagebox.showerror("打印错误", f"打印失败：{str(e)}"))
                self.master.after(0, lambda: self.print_button.config(state=tk.NORMAL))
                return

        self.master.after(0, lambda: self.print_button.config(state=tk.NORMAL))

    def update_counter_in_gui(self):
        """在GUI线程内更新计数器，避免线程安全问题"""
        self.counter += 1
        self.update_counter()

    def refresh_labels(self):
        self.total_labels = self.get_total_labels()
        self.counter = 0
        self.update_counter()
        self.print_button.config(state=tk.NORMAL)
        self.counter_label.config(fg='black')

    def update_counter(self):
        if self.counter >= self.total_labels:
            self.counter_label.config(
                text='所有标签已打印完成！', fg='green')
        else:
            self.counter_label.config(text='{} of {} labels printed'.format(
                self.counter, self.total_labels))


# 启动GUI
root = tk.Tk()
app = App(master=root)
app.mainloop()

额外提示 #

• 如果你的标签需要特定排版（比如条码、自定义格式），RAW模式直接发送文本可能无法满足需求，可以考虑用reportlab生成PDF后再调用系统打印功能。

内容的提问来源于stack exchange，提问作者Anthony Madle