子线程执行蓝牙扫描触发nextEventMatchingMask警告的问题排查

先搞懂警告为啥来 #

这个警告是macOS系统给你提的醒——nextEventMatchingMask是苹果Cocoa框架里的事件处理API，Python的bluetooth库底层调用了系统蓝牙服务，而这些服务要求和系统事件相关的操作必须在主线程执行。你把蓝牙扫描扔到子线程里，就踩了这个坑。

你看到的“让出主线程”，其实是说：像蓝牙、GUI这类依赖系统事件循环的操作，不能在子线程里抢着干，得让主线程来处理这些系统级的事件，子线程别碰这类API。

你的代码问题出在哪 #

看你的BluetoothClass.main方法，直接在子线程里调用bluetooth.discover_devices()，这个方法底层会触发系统蓝牙的事件查询，而这个操作只能由主线程来做，所以警告就弹出来了。

给你两个实用解决办法 #

办法1：子线程做调度，扫描逻辑交主线程（通用非GUI场景） #

让子线程只负责定时触发扫描请求，核心的蓝牙扫描操作放在主线程执行，既不阻塞主程序，又符合系统要求：

# mainprogram.py
import threading
import time
import queue
from bluetoothstuff import BluetoothClass

class MainClass():
    def __init__(self):
        self._scan_queue = queue.Queue()
        self._stop_flag = threading.Event()

    def something(self):
        # 启动子线程负责定时发送扫描请求
        threading.Thread(target=self._scan_scheduler, daemon=True).start()
        # 主线程持续处理扫描请求
        self._process_scan_tasks()

    def _scan_scheduler(self):
        while not self._stop_flag.is_set():
            self._scan_queue.put("scan")
            time.sleep(5)  # 每5秒触发一次扫描

    def _process_scan_tasks(self):
        while not self._stop_flag.is_set():
            try:
                req = self._scan_queue.get(timeout=1)
                if req == "scan":
                    BluetoothClass.scan_devices()
                self._scan_queue.task_done()
            except queue.Empty:
                continue

if __name__ == '__main__':
    start = MainClass()
    start.something()
    try:
        input("Press Enter to exit...\n")
    finally:
        start._stop_flag.set()

# bluetoothstuff.py
import bluetooth

class BluetoothClass():
    @staticmethod
    def scan_devices():
        devices = bluetooth.discover_devices(lookup_names=True)
        print("发现蓝牙设备：", devices)

办法2：用主线程事件循环（适合GUI场景） #

如果你的主程序是GUI（比如Tkinter、PyQt），直接用GUI的事件循环来定时执行扫描，完美契合系统要求：

# 以Tkinter为例
import tkinter as tk
import bluetooth

class MainApp(tk.Tk):
    def __init__(self):
        super().__init__()
        self.title("蓝牙扫描工具")
        self.scan_interval = 5000  # 5秒一次，单位毫秒
        self._start_scan_loop()

    def _start_scan_loop(self):
        self._perform_scan()
        # 定时调用自身，实现循环扫描
        self.after(self.scan_interval, self._start_scan_loop)

    def _perform_scan(self):
        devices = bluetooth.discover_devices(lookup_names=True)
        print("扫描到设备：", devices)
        # 也可以把结果显示到GUI组件上
        # self.result_label.config(text=f"扫描到{len(devices)}个设备")

if __name__ == '__main__':
    app = MainApp()
    app.mainloop()

再补两个你关心的点 #

1. 关于nextEventMatchingMask：这是macOS底层Cocoa框架的方法，用来处理系统事件循环，不属于Python标准库，所以你在Python文档里搜不到很正常。
2. 主线程到底是哪个：运行if __name__ == '__main__'的那个线程就是主线程，你创建的mythread是子线程——蓝牙API要求相关操作必须在主线程执行，你放到子线程里就违反了这个规则，所以警告就来了。

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