GTK旋转按钮更新触发[xcb]错误，求故障排查及解决方法

你遇到的这个错误核心原因就是在UI创建线程之外的线程里直接更新GTK控件——虽然你提到其他更新操作看似正常，但这只是巧合（那些操作没触发X11底层的线程安全断言），GTK的UI操作本质上是线程非安全的，所有对控件的修改都必须在创建UI的主线程中执行。

错误信息解读 #

报错里的[xcb] Unknown request in queue while dequeuing和multi-threaded client and XInitThreads has not been called提示已经很明确：X11（GTK基于X11时的底层依赖）的线程安全机制没被正确初始化，且你在非主线程发起了UI操作，导致X11的请求队列混乱，触发了断言崩溃。

解决方法 #

你需要用GTK提供的线程安全机制，把UI更新操作提交到主线程执行，而不是在后台线程直接调用控件的set_value方法。具体分两种情况：

如果你用的是GTK3

使用GObject.idle_add()将更新任务加入主线程的事件循环队列：

# 先把更新逻辑封装成一个函数
def update_spin_values(self, cvt):
    if cvt != self._cvt:
        self._cvt = cvt
        tcond_sp_lbl.set_value(self._cvt["tcond"])
        tsat_sp_lbl.set_value(self._cvt["tsat"])

# 在你的后台线程中，不要直接调用update_spin_values，而是用：
from gi.repository import GObject
GObject.idle_add(self.update_spin_values, cvt)

如果你用的是GTK4

使用Gtk.Application.invoke()方法，它是GTK4推荐的线程安全UI更新方式：

# 同样封装更新逻辑
def update_spin_values(self, cvt):
    if cvt != self._cvt:
        self._cvt = cvt
        tcond_sp_lbl.set_value(self._cvt["tcond"])
        tsat_sp_lbl.set_value(self._cvt["tsat"])

# 在后台线程中调用：
self.application.invoke(self.update_spin_values, cvt)

补充说明 #

你提到其他更新操作正常，这是因为不同GTK控件对非线程安全操作的“容忍度”不同——有些操作可能没有直接触达X11的底层请求队列，暂时没崩溃，但这种操作是不可靠的，随时可能因为线程竞争导致奇怪的崩溃或UI异常。所以所有UI相关的操作都必须通过线程安全的方式提交到主线程执行，不要抱有侥幸心理。

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