使用PyInstaller打包带Captcha的Tkinter登录脚本转Exe后报错求解决

问题背景 #

使用命令pyinstaller --noconfirm --onefile --windowed "C:/Users/Administrator/Documents/VS CODE DEVELOPMENT/Micheal app/Tkinter Login Page/LoginPage.py"将带Captcha功能的Tkinter登录脚本打包为单文件窗口版Exe，脚本本地运行正常，但打包后执行报错，已移除外部图片排查无效，核心代码如下：

from captcha.image import ImageCaptcha
import random

# Define a function to generate a random captcha string
def generate_captcha():
    # Define the character set for the captcha
    char_set = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'
    captcha = ''
    # Generate a random 6-character captcha string
    for i in range(6):
        captcha += random.choice(char_set)
    return captcha

# Define a function to create a captcha image and display it in the GUI
def create_captcha_image():
    captcha = generate_captcha()
    image = ImageCaptcha().generate(captcha)
    # Convert the captcha image to a Tkinter PhotoImage
    photo = tk.PhotoImage(data=image.getvalue())
    captcha_label.configure(image=photo)
    captcha_label.image = photo
    return captcha

# Define a function to handle the form submission
def submit_form():
    email = email_entry.get()
    password = password_entry.get()
    user_captcha = captcha_entry.get()
    # Validate the captcha
    if user_captcha == captcha_text:
        print(f"Email: {email}\nPassword: {password}")
        # Add code to create the account here
    else:
        print("Incorrect captcha, please try again.")
        create_captcha_image()

# Create a GUI window
root = tk.Tk()
root.title("Create an Account")

# Create a label and entry for the email address
email_label = tk.Label(root, text="Email Address:")
email_label.pack()
email_entry = tk.Entry(root)
email_entry.pack()

# Create a label and entry for the password
password_label = tk.Label(root, text="Password:")
password_label.pack()
password_entry = tk.Entry(root, show="*")
password_entry.pack()

# Create a label and entry for the captcha
captcha_text = generate_captcha()
captcha_label = tk.Label(root)
captcha_label.pack()
captcha_image = ImageCaptcha().generate(captcha_text)
photo = tk.PhotoImage(data=captcha_image.getvalue())
captcha_label.configure(image=photo)
captcha_label.image = photo
captcha_entry = tk.Entry(root)
captcha_entry.pack()

# Create a button to submit the form
submit_button = tk.Button(root, text="Create Account", command=submit_form)
submit_button.pack()

# Run the GUI window
root.mainloop()

解决方案 #

1. 补全缺失的tkinter导入 #

原代码中使用了tk模块但未显式导入，PyInstaller无法识别隐式依赖，在代码最开头添加：

import tkinter as tk

2. 处理ImageCaptcha的字体依赖 #

captcha库默认依赖系统字体，单文件打包后无法正常读取，可通过两种方式解决：

• 方式一：修改打包命令包含字体文件
  找到Python安装目录下captcha库的字体路径（通常为Lib/site-packages/captcha/fonts），修改PyInstaller命令：

  pyinstaller --noconfirm --onefile --windowed --add-data "C:/PythonXX/Lib/site-packages/captcha/fonts/*;captcha/fonts" "LoginPage.py"
  

  替换C:/PythonXX为你的实际Python安装路径。

• 方式二：代码中指定字体路径
  初始化ImageCaptcha时指定字体文件的绝对路径，确保打包时字体被包含：

  # 替换原ImageCaptcha()调用，示例：
  image = ImageCaptcha(fonts=["C:/PythonXX/Lib/site-packages/captcha/fonts/LiberationSans-Bold.ttf"]).generate(captcha)
  

3. 适配单文件模式的临时资源路径 #

单文件打包后，PyInstaller会将资源解压到临时目录，需通过代码获取正确路径：

import sys
import os

def get_resource_path(relative_path):
    try:
        # 打包后的临时目录路径
        base_path = sys._MEIPASS
    except Exception:
        # 未打包时的本地路径
        base_path = os.path.abspath(".")
    return os.path.join(base_path, relative_path)

# 初始化ImageCaptcha时使用该路径
image = ImageCaptcha(fonts=[get_resource_path("captcha/fonts/LiberationSans-Bold.ttf")]).generate(captcha)

4. 查看详细报错日志 #

暂时去掉--windowed参数打包，生成带控制台的Exe，运行时可看到具体错误信息，快速定位问题：

pyinstaller --noconfirm --onefile "LoginPage.py"

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