Python3.8调用ConvertAPI触发Tkinter多窗口实例异常求助

我之前遇到过类似的兼容性问题，根源大概率是ConvertAPI的调用阻塞了Tkinter的主循环，或是某些内部依赖意外触发了Tkinter的默认窗口创建逻辑。下面是几个经过验证的解决方案：

方案1：将ConvertAPI调用放在子线程中执行 #

Tkinter是单线程框架，如果在主线程中执行耗时的网络请求（调用ConvertAPI本质是向云端发送请求），会导致主循环阻塞，进而引发各种异常行为（包括意外创建多个窗口）。把合并逻辑放到子线程中可以彻底避免这个问题：

from tkinter import *
import convertapi
import threading
import tkinter.messagebox as messagebox

input_files = ["file1.pdf", "file2.pdf", "file3.pdf"]
output_file = "mergedFile.pdf"

def mergePDFs(input_files, output_file):
    def run_merge_task():
        # 在子线程中执行ConvertAPI调用
        convertapi.api_secret = 'my-api-secret'
        try:
            result = convertapi.convert('merge', {'Files': input_files})
            result.file.save(output_file)
            # 回到主线程弹出成功提示（Tkinter操作必须在主线程执行）
            root.after(0, lambda: messagebox.showinfo("成功", "PDF合并完成！"))
        except Exception as e:
            root.after(0, lambda: messagebox.showerror("错误", f"合并失败：{str(e)}"))
    
    # 启动守护线程执行合并任务
    threading.Thread(target=run_merge_task, daemon=True).start()

root = Tk()
Button(root, text="Merge", command=lambda: mergePDFs(input_files, output_file)).pack()
root.mainloop()

方案2：禁用Tkinter的默认根窗口自动创建 #

有些第三方库可能会间接触发tkinter的默认根窗口创建，通过提前禁用这个行为，可以防止意外窗口弹出：

from tkinter import *
# 禁用自动创建默认根窗口，必须显式创建Tk实例
Tk._create_default_root = False
import convertapi

input_files = ["file1.pdf", "file2.pdf", "file3.pdf"]
output_file = "mergedFile.pdf"

def mergePDFs(input_files, output_file):
    convertapi.api_secret = 'my-api-secret'
    result = convertapi.convert('merge', {'Files': input_files})
    result.file.save(output_file)

root = Tk()
Button(root, text="Merge", command=lambda: mergePDFs(input_files, output_file)).pack()
root.mainloop()

方案3：更新ConvertAPI到最新版本 #

旧版本的ConvertAPI SDK可能存在与tkinter的兼容性bug，尝试更新到最新版本：

pip install --upgrade convertapi

额外提示 #

• 永远不要在Tkinter的主线程中执行耗时操作（比如网络请求、大文件处理），这不仅会导致界面卡顿，还可能引发各种难以排查的异常。
• 如果合并完成后需要更新界面，一定要用root.after(0, callback)回到主线程执行Tkinter操作，因为子线程不能直接操作Tkinter组件。

内容的提问来源于stack exchange，提问作者Benjamin Hennequart