RuntimeWarning: coroutine 'xxx' was never awaited 表示异步函数未被 await 调用，仅返回协程对象；常见于 Tkinter+threading 中将 async 函数直接传入 Thread.target，或误用协程列表而未用 asyncio.gather 并发执行。
RuntimeWarning: coroutine 'xxx' was never awaited 是什么问题
这不是错误，但代表你的异步函数根本没执行。比如写了 background_task() 却没加 await，它就只返回一个 coroutine 对象，Python 会警告你“这玩意儿没人管”。在 Tkinter + threading 场景下，常见于把 async def 函数直接塞进 threading.Thread(target=...) —— 线程启动时调用它，得到的是协程对象，不是运行结果。
- 用
isinstance(obj, asyncio.Coroutine)检查变量类型，如果是True，就必须await -
[fetch(u) for u in urls]生成的是协程列表，不是结果列表；要并发执行得用await asyncio.gather(*coro_list) - 在 Jupyter 或 FastAPI 依赖里调
asyncio.run()，也会触发嵌套 loop 报错，和这个警告常伴生
为什么不能在子线程里直接调 asyncio.run() 启动后台任务
表面上看 asyncio.run() 能跑通，但它默认绑定当前线程的事件循环策略。Tkinter 的主线程已经启动了自己的 loop（哪怕没显式调用），此时子线程里再调 asyncio.run()，可能撞上策略冲突或 loop 复用问题，尤其在 Windows 或打包后的 exe 中容易静默失败或卡死。
- 正确做法是：子线程内手动创建并管理自己的 loop，用
asyncio.new_event_loop()+set_event_loop()，再run_until_complete() - 更稳妥的替代是：用
asyncio.run_coroutine_threadsafe(coro, loop)，把协程提交给**已存在的主线程 loop**（需提前拿到该 loop 引用） - 千万别在子线程里调
asyncio.get_event_loop()—— 它可能返回None或抛RuntimeError: There is no current event loop
如何让 async 任务安全更新 Tkinter 界面
Tkinter 所有 UI 操作必须在主线程，async 任务跑在子线程或事件循环里，两者不能直连。最轻量可靠的桥接方式是 root.after()，它把回调排入 Tkinter 主循环队列，确保执行上下文正确。
- 不要在 async 函数里直接调
label.config()，哪怕加了threading.Lock也无效 - 子线程中完成计算后，用
root.after(0, lambda: update_ui(data))提交 UI 更新（0表示下一帧立刻执行） - 如果数据复杂（如嵌套 dict），避免传可变对象；简单类型（
str/int）或深拷贝后再传 - 别在
after回调里再起线程或调time.sleep()，否则整个 GUI 会卡住
asyncio.Lock 和 threading.Lock 绝对不能混用
全局缓存同时被 Tkinter 主线程（同步逻辑）、后台线程（ThreadPoolExecutor）、以及 async 协程（asyncio.create_task）访问时，锁必须按调度模型分层：线程间用 threading.Lock，协程间用 asyncio.Lock，跨层访问必须拆开保护。
立即学习“Python免费学习笔记（深入）”；
- 错误示范：
async with asyncio.Lock(): await db_query()—— 这锁不住线程池里的同步查询 - 正确分层：共享字典
cache用threading.Lock保护；协程内部的临时状态（如 pending request set）用asyncio.Lock - 若必须统一保护，优先用
threading.Lock，并在 async 函数中用loop.run_in_executor(None, lambda: cache_access())把操作交到线程池执行
