Python：Socket收客户端消息后在单个Tkinter GUI更新显示的问题

问题根源 #

原服务端代码中，gui函数每次被调用时都会创建新的tkinter.Tk()实例并启动mainloop()，这导致每收到一条客户端消息就会弹出新窗口。同时，直接在子线程中操作Tkinter组件会引发线程安全问题。

修改后的服务端代码 #

import socket
import threading
import tkinter
from tkinter import simpledialog

host = '127.0.0.1'
port = 6005
server = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
server.bind((host, port))
server.listen()
balance = 0

# 全局GUI元素，只初始化一次
root = None
balance_label = None

def update_balance(new_value):
    """在主线程中更新GUI标签内容"""
    global balance_label
    balance_label.config(text=f"You current balance is: {new_value}")

def handler(client):
    global balance
    while True:
        try:
            message = client.recv(1024)
            if not message:
                break
            message = message.decode('utf-8')
            # 更新余额
            balance += int(message)
            print(balance)
            # 使用after方法在主线程更新GUI
            root.after(0, update_balance, balance)
        except Exception as e:
            print(f"Error: {e}")
            break
    client.close()

def init_gui():
    """初始化唯一的GUI窗口"""
    global root, balance_label
    root = tkinter.Tk()
    root.title("Server")
    root.geometry("300x200")
    balance_label = tkinter.Label(root, text=f"You current balance is: {balance}")
    balance_label.pack(pady=50)
    # 启动GUI主循环后，开启接收客户端连接的线程
    threading.Thread(target=receive, daemon=True).start()
    root.mainloop()

def receive():
    while True:
        try:
            client, address = server.accept()
            print(f"connected with {str(address)}")
            thread = threading.Thread(target=handler, args=(client,), daemon=True)
            thread.start()
        except Exception as e:
            print(f"Receive error: {e}")
            break
    server.close()

# 启动GUI初始化（主线程）
init_gui()

关键改动说明 #

• 单一GUI初始化：将GUI窗口和标签的创建放在init_gui函数中，仅在程序启动时执行一次，确保只有一个窗口。
• 线程安全的GUI更新：Tkinter组件只能在主线程中修改，因此使用root.after(0, update_balance, balance)将更新操作调度到主线程执行，避免线程冲突。
• 守护线程：将接收客户端和处理消息的线程设置为守护线程，这样当GUI窗口关闭时，程序能正常退出。
• 修正连接关闭逻辑：原代码中错误地在handler里关闭了服务端，改为关闭当前客户端连接，避免影响其他客户端接入。

客户端代码（无需修改） #

from tkinter import *
import socket
HOST = '127.0.0.1'
PORT = 6005

cli = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
root = Tk()
root.title("client")
root.geometry("300x200")
e = Entry(root, width=50, bg="white", fg="black")
e.pack()

cli.connect((HOST, PORT))
def button_click():
    x = e.get()
    message = str(x)
    cli.send(message.encode('utf-8'))
    count.config(text=message)


OTP = Button(root, text="Send Transfer", padx=20, pady=10, command=button_click)
OTP.pack()
count = Label(root)
count.pack()
root.mainloop()

内容的提问来源于stack exchange，提问作者Anthony J. B.