_tkinter.TclError栈空间不足问题排查与修复求助

仅在某特定机器运行Python 3.7.4的Tkinter程序时，出现_tkinter.TclError: out of stack space (infinite loop?)错误，其他机器运行正常。程序包含线程循环操作Tkinter组件的逻辑，移除线程或循环则无问题；出问题的机器默认Python版本为2.7，但实际运行的是3.7.4。

报错堆栈 #

Exception in thread Thread-1: Traceback (most recent call last):   File "/usr/pkgs/python3/3.7.4/lib/python3.7/threading.py", line 926, in _bootstrap_inner
    self.run()   File "/usr/pkgs/python3/3.7.4/lib/python3.7/threading.py", line 870, in run
    self._target(*self._args, **self._kwargs)   File "example_gui_2.py", line 45, in test
    textbox.config(state=NORMAL)   File "/usr/pkgs/python3/3.7.4/lib/python3.7/tkinter/__init__.py", line 1485, in configure
    return self._configure('configure', cnf, kw)   File "/usr/pkgs/python3/3.7.4/lib/python3.7/tkinter/__init__.py", line 1476, in _configure
    self.tk.call(_flatten((self._w, cmd)) + self._options(cnf))
_tkinter.TclError: out of stack space (infinite loop?)

示例代码（example_gui_2.py） #

import tkinter as tk
import subprocess
import threading
import sys
from functools import partial


def run(textbox=None):
    threading.Thread(target=test, args=[textbox]).start()


def test(textbox=None):
    # using the Python executable to run demo_print.py
    p = subprocess.Popen([sys.executable, "-u", "demo_print.py"], stdout=subprocess.PIPE, bufsize=1, text=True)
    while p.poll() is None:
        msg = p.stdout.readline().strip()  # read a line from the process output
        if msg:
            textbox.config(state=NORMAL)
            textbox.insert(tk.END, msg + "\n")
            textbox.see(tk.END)
            textbox.update_idletasks()
            textbox.config(state=DISABLED)


if __name__ == "__main__":
    fenster = tk.Tk()
    fenster.title("My Program")
    textbox = tk.Text(fenster)
    textbox.grid(row=0, column=0)
    scrollbar = tk.Scrollbar(fenster, orient=tk.VERTICAL)
    scrollbar.grid(row=0, column=1, sticky="ns")

    textbox.config(yscrollcommand=scrollbar.set)
    scrollbar.config(command=textbox.yview)

    start_button = tk.Button(fenster, text="Start", command=partial(run, textbox))
    start_button.grid()

    fenster.mainloop()

解决思路 #

1. 严格遵循Tkinter线程规则：主线程唯一操作GUI组件 #

Tkinter的GUI组件并非线程安全，子线程直接调用组件方法（如textbox.config、textbox.insert）会引发Tcl/Tk内部线程冲突，在特定环境下触发栈溢出。正确做法是让子线程仅负责数据获取，主线程处理UI更新：

• 引入queue.Queue作为线程安全的消息队列，子线程将输出消息存入队列
• 主线程通过after()定时从队列取消息，更新Text组件

修改后的示例代码：

import tkinter as tk
import subprocess
import threading
import sys
import queue
from functools import partial

msg_queue = queue.Queue()

def run(textbox=None):
    threading.Thread(target=test, daemon=True).start()
    # 启动主线程的UI更新循环
    fenster.after(100, update_textbox, textbox)

def test():
    p = subprocess.Popen([sys.executable, "-u", "demo_print.py"], stdout=subprocess.PIPE, bufsize=1, text=True)
    for msg in iter(p.stdout.readline, ''):
        msg = msg.strip()
        if msg:
            msg_queue.put(msg)
    p.wait()

def update_textbox(textbox):
    while not msg_queue.empty():
        msg = msg_queue.get()
        textbox.config(state=tk.NORMAL)
        textbox.insert(tk.END, msg + "\n")
        textbox.see(tk.END)
        textbox.config(state=tk.DISABLED)
    # 持续触发更新检查
    fenster.after(100, update_textbox, textbox)

if __name__ == "__main__":
    fenster = tk.Tk()
    fenster.title("My Program")
    textbox = tk.Text(fenster)
    textbox.grid(row=0, column=0)
    scrollbar = tk.Scrollbar(fenster, orient=tk.VERTICAL)
    scrollbar.grid(row=0, column=1, sticky="ns")

    textbox.config(yscrollcommand=scrollbar.set)
    scrollbar.config(command=textbox.yview)

    start_button = tk.Button(fenster, text="Start", command=partial(run, textbox))
    start_button.grid()

    fenster.mainloop()

2. 检查Tcl/Tk版本兼容性 #

出问题的机器默认Python2.7，可能系统自带的Tcl/Tk版本较低（如8.5及以下），而Python3.7.4建议搭配Tcl/Tk 8.6版本，版本不匹配会导致线程交互异常：

• 在Python终端执行以下命令查看当前Tcl版本：

  import tkinter
  print(tkinter.TclVersion)
  

• 如果版本低于8.6，可尝试升级系统的Tcl/Tk库，或使用Python发行版自带的Tcl/Tk（如Anaconda、Python官方安装包通常会自带适配版本）

3. 优化子进程输出读取逻辑 #

原代码中while p.poll() is None的循环可能在子进程输出频繁时导致线程持续高负载，加剧线程冲突。改用iter(p.stdout.readline, '')的方式可更安全地读取子进程输出，避免空循环。

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