开启 asyncio.debug 模式（如 asyncio.run(main(), debug=true)）可暴露挂起任务的完整堆栈，定位未 await 协程、跨线程误用或第三方库 cleanup 遗漏等根本原因。
asyncio.run() 报错说“Task was destroyed but it is pending”怎么定位
这是 asyncio 最典型的挂起问题：某个 async 任务没被 await 就结束了，或被取消时还在运行。默认模式下只报错不指明是哪个协程、在哪挂起。
关键不是看错误文字，而是让 asyncio 主动暴露挂起任务的堆栈。必须开启调试模式：
- 启动时加参数：
asyncio.run(main(), debug=True) - 或全局启用：
asyncio.get_event_loop().set_debug(True)（需在事件循环创建后、运行前调用） - 环境变量也有效：
PYTHONASYNCIODEBUG=1 python script.py
开启后，一旦有未完成的 pending task，会打印完整 traceback，包括该 task 的创建位置（create_task 或 ensure_future 调用点）和当前挂起的 await 行——这才是真正有用的线索。
为什么 asyncio.get_running_loop() 在主线程外报 RuntimeError
常见于多线程场景：你在子线程里直接调用 asyncio.get_running_loop()，但 asyncio 的事件循环默认只绑定在主线程。这不是 bug，是设计限制。
解决方式取决于你要做什么：
- 如果只是想在子线程里跑异步逻辑：用
asyncio.run_coroutine_threadsafe(coro, loop)，把协程提交给主线程的 loop 执行 - 如果子线程必须有自己的 event loop：手动创建并设置为当前线程的 running loop，例如：
loop = asyncio.new_event_loop(); asyncio.set_event_loop(loop); loop.run_until_complete(coro) - 切勿在子线程里调用
asyncio.run()—— 它会新建 loop 并阻塞，且无法被主线程 loop 管理，极易导致挂起任务残留
debug 模式下这类线程误用也会触发更详细的警告，比如 “coroutine object created in thread X but awaited in thread Y”。
await 一个没 await 的协程对象却不报错，怎么发现它其实没执行
Python 不会报错，但你的协程根本没进事件循环——它只是个对象，像 main() 返回 <coroutine object main at></coroutine>，但你忘了加 await。
这种漏 await 是静默挂起的高发原因。debug 模式能捕获它：
- 开启
debug=True后，若协程对象被垃圾回收但从未被调度，会输出 warning：“Executing__del__on coroutine object …” 并附上协程定义处的源码行 - 更直接的办法：用
asyncio.create_task()替代裸调用协程，因为create_task会立即调度，漏写 await 会导致明显异常（如 RuntimeWarning: coroutine ‘xxx’ was never awaited） - 静态检查工具如
pylint（启用unnecessary-await和not-async-context-manager规则）也能提前发现这类模式
挂起任务出现在第三方库（如 httpx、aiohttp）里，怎么判断是不是它们的锅
不能直接甩锅。先确认是否是自己代码触发了未完成的生命周期管理：
- 检查是否用了
httpx.AsyncClient()但忘了await client.aclose()或没用async with client: - 检查
aiohttp.ClientSession()是否在async with块外就退出了作用域，导致 session 关闭延迟，内部 cleanup task 挂起 - 用
asyncio.all_tasks()打印当前所有 task，过滤掉asyncio.tasks._PyTask类型，重点看名字含 “http”, “request”, “timeout” 的 task，再查它的get_coro().__code__.co_filename定位来源
debug 模式下，这些第三方库内部的 pending task 也会带出完整的 await 链，通常能追溯到你调用 client.get() 那一行——问题往往不在库本身，而在你没等它返回，或没处理异常分支导致 cleanup 被跳过。
asyncio 的挂起问题本质是控制流断裂，debug 模式只是把断裂点显性化；真正要盯住的，是你代码里每一个 create_task、每一个 async with、每一个 await 的配对关系。漏掉任意一环，都可能变成后台无声运行的幽灵 task。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
