Tkinter回调间歇性异常：右键菜单设置按钮文本失败排查

我正在构建一个计分板，右键点击按钮弹出菜单选择值来更新按钮文本。弹窗可正常显示并选择值，90%的情况下选中值能成功写入按钮文本，但有10%的概率触发错误。

报错相关代码 #

def popup1_6(event, btn_name):
    print("popup= ", btn_name)
    # Add Menu
    popup = Menu(canvas, tearoff=0)
    # Adding Menu Items
    popup.add_command(label="", command=lambda: wrvalue(event, " "))
    popup.add_command(label="0", command=lambda: wrvalue(event, "0"))
    popup.add_command(label=str(int(btn_name[1]) * 1), command=lambda: wrvalue(event, str(int(btn_name[1]) * 1)))
    popup.add_command(label=str(int(btn_name[1]) * 2), command=lambda: wrvalue(event, str(int(btn_name[1]) * 2)))
    popup.add_command(label=str(int(btn_name[1]) * 3), command=lambda: wrvalue(event, str(int(btn_name[1]) * 3)))
    popup.add_command(label=str(int(btn_name[1]) * 4), command=lambda: wrvalue(event, str(int(btn_name[1]) * 4)))
    popup.add_command(label=str(int(btn_name[1]) * 5), command=lambda: wrvalue(event, str(int(btn_name[1]) * 5)))
    try:
        popup.tk_popup(event.x_root + 50, event.y_root + 30, 0)
    finally:
        popup.grab_release()


def wrvalue(event, value):
    print('Value1=', value)
    event.widget.configure(text=value)
    print('Event= ', event.widget)
    text = event.widget.cget("text")
    print('btntext=', text)
    if text != str(value):
        print('text not equal to value')

错误信息 #

You right clicked...
Rbtnname=  U1P1
popup=  U1P1
Value1= 3
Event=  .!canvas.!ctkframe2.!ctkbutton.!label
btntext= 3
You right clicked...
Rbtnname=  F2P1
popup=  F2P1
Value1= 0
Exception in Tkinter callback
Traceback (most recent call last):
  File "/Library/Frameworks/Python.framework/Versions/3.11/lib/python3.11/tkinter/__init__.py", line 1948, in __call__
    return self.func(*args)
           ^^^^^^^^^^^^^^^^
  File "/Users/joep/PycharmProjects/TrippleYathzee/venv/Main.py", line 258, in <lambda>
    popup.add_command(label="0", command=lambda: wrvalue(event, "0"))
                                                 ^^^^^^^^^^^^^^^^^^^
  File "/Users/joep/PycharmProjects/TrippleYathzee/venv/Main.py", line 272, in wrvalue
    event.widget.configure(text=value)
  File "/Library/Frameworks/Python.framework/Versions/3.11/lib/python3.11/tkinter/__init__.py", line 1702, in configure
    return self._configure('configure', cnf, kw)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Library/Frameworks/Python.framework/Versions/3.11/lib/python3.11/tkinter/__init__.py", line 1692, in _configure
    self.tk.call(_flatten((self._w, cmd)) + self._options(cnf))
_tkinter.TclError: unknown option "-text"

问题根源 #

从错误日志的Event= .!canvas.!ctkframe2.!ctkbutton.!label可以看出，偶尔event.widget指向的是CTkButton内部的Label子组件，而非CTkButton本身。右键事件触发时，若光标恰好落在按钮内部的Label区域，事件会被这个子组件捕获，而该组件不支持通过configure(text=...)来修改文本（CTkButton的文本更新需要通过按钮对象本身操作），从而抛出错误。

解决方案 #

不要依赖event.widget获取目标按钮，直接将按钮对象传递给更新函数，确保始终操作正确的组件：

1. 修改按钮的右键绑定方式，传入按钮对象而非按钮名称：

   # 原绑定方式（传入btn_name）
   # btn.bind("<Button-3>", lambda e: popup1_6(e, btn_name))
   # 修改为传入按钮对象
   btn.bind("<Button-3>", lambda e: popup1_6(e, btn))
   

2. 更新popup1_6函数，接收按钮对象并在菜单命令中直接引用：

   def popup1_6(event, target_btn):
       btn_name = target_btn.cget("text")
       print("popup= ", btn_name)
       popup = Menu(canvas, tearoff=0)
       # 菜单命令直接传递目标按钮对象
       popup.add_command(label="", command=lambda: wrvalue(target_btn, " "))
       popup.add_command(label="0", command=lambda: wrvalue(target_btn, "0"))
       base_value = int(target_btn.cget("text")[1])
       popup.add_command(label=str(base_value * 1), command=lambda: wrvalue(target_btn, str(base_value * 1)))
       popup.add_command(label=str(base_value * 2), command=lambda: wrvalue(target_btn, str(base_value * 2)))
       popup.add_command(label=str(base_value * 3), command=lambda: wrvalue(target_btn, str(base_value * 3)))
       popup.add_command(label=str(base_value * 4), command=lambda: wrvalue(target_btn, str(base_value * 4)))
       popup.add_command(label=str(base_value * 5), command=lambda: wrvalue(target_btn, str(base_value * 5)))
       try:
           popup.tk_popup(event.x_root + 50, event.y_root + 30, 0)
       finally:
           popup.grab_release()
   

3. 修改wrvalue函数，接收按钮对象而非事件：

   def wrvalue(target_btn, value):
       print('Value1=', value)
       target_btn.configure(text=value)
       print('Btn= ', target_btn)
       text = target_btn.cget("text")
       print('btntext=', text)
       if text != str(value):
           print('text not equal to value')
   

额外说明 #

这种修改彻底避免了事件传递带来的组件不确定性，确保每次更新操作的都是目标按钮本身，从根源解决间歇性报错问题。

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