
在python的异步编程中,asyncio是核心库,它通过事件循环(event loop)来调度和执行协程(coroutines)。一个被async def关键字定义的函数是一个协程函数,调用它会返回一个协程对象,而不是立即执行其内容。要真正运行协程的逻辑,必须将其“调度”到事件循环中并“等待”(await)它。
当你在一个异步上下文中(例如在一个async函数内部)调用另一个协程时,你会使用await关键字。例如:await some_async_function()。然而,如果你尝试在一个同步线程中直接将一个协程对象作为threading.Thread的目标函数,例如threading.Thread(target=my_async_coroutine),那么这个协程对象将永远不会被await,因为它没有被调度到任何事件循环中。这就是导致RuntimeWarning: coroutine '...' was never awaited的原因。
考虑一个常见的场景:你正在构建一个基于socketio的异步WebSocket服务器,该服务器需要一个后台任务来持续从外部服务(如AWS SQS)接收消息,并将这些消息实时推送给连接的客户端。这个后台任务本身也设计为异步协程,以避免阻塞。
原始代码尝试使用threading.Thread来启动后台任务,但由于background_task是一个协程,直接将其作为线程目标会导致上述警告,并且任务无法正常运行:
import socketio
import threading
import json
# from sqs_handler import SQSQueue # 假设这是一个处理SQS的类
sio = socketio.AsyncServer(async_mode='asgi')
app = socketio.ASGIApp(sio, static_files={"/": "./"})
@sio.event
async def connect(sid, environ):
print(sid, "connected")
@sio.event
async def disconnect(sid):
print(sid, "disconnected")
async def background_task():
# queue = SQSQueue()
print("后台任务启动,等待SQS消息...")
while True:
# message = queue.get_next_message_from_sqs() # 假设这里会阻塞或需要await
# data = json.loads(message.body)
# await sio.emit('item_added', data)
# 模拟异步操作
await asyncio.sleep(1) # 模拟从SQS获取消息的延迟
print("后台任务正在运行...")
await sio.emit('item_added', {'message': 'New item added from background!'})
# 错误的方式:直接将协程对象作为线程目标
# background_thread = threading.Thread(target=background_task)
# background_thread.daemon = True
# background_thread.start()解决此问题的关键在于,每个asyncio协程都必须在一个事件循环中被await。当我们在一个新线程中运行一个协程时,这个新线程需要有它自己的事件循环。asyncio.run()函数正是为此设计的:它会创建一个新的事件循环,运行给定的协程直到完成,然后关闭该循环。
立即学习“Python免费学习笔记(深入)”;
因此,正确的做法是将asyncio.run()作为threading.Thread的目标函数,并将我们的后台协程作为asyncio.run()的参数传递。
关键修改:
以下是修正后的代码示例:
import socketio
import threading
import json
import asyncio # 1. 导入 asyncio
# 假设 SQSQueue 能够以非阻塞方式获取消息,或者其内部处理了阻塞
# 为了演示,我们创建一个模拟的 SQSQueue
class SQSQueue:
def get_next_message_from_sqs(self):
# 模拟阻塞操作,实际应用中应使用异步 SQS 客户端
import time
time.sleep(0.5)
return type('obj', (object,), {'body': json.dumps({'id': 123, 'status': 'added', 'data': 'example'})})()
sio = socketio.AsyncServer(async_mode='asgi')
app = socketio.ASGIApp(sio, static_files={"/": "./"})
@sio.event
async def connect(sid, environ):
print(f"客户端 {sid} 已连接")
@sio.event
async def disconnect(sid):
print(f"客户端 {sid} 已断开")
@sio.event
async def item_removed(sid, data):
print(f"收到 item_removed 事件,数据: {data}")
await sio.emit("item_removed", data)
async def background_task():
"""
后台任务:从SQS接收消息并发送给所有连接的客户端。
此协程将在独立的事件循环中运行。
"""
queue = SQSQueue()
print("后台任务启动,等待SQS消息...")
while True:
try:
# 注意:如果 get_next_message_from_sqs 是阻塞的,它会阻塞此线程的事件循环。
# 理想情况下,SQSQueue 应该使用异步客户端(如 aiobotocore)并提供 awaitable 方法。
message = queue.get_next_message_from_sqs()
data = json.loads(message.body)
print(f"从SQS接收到消息: {data},准备发送给客户端")
await sio.emit('item_added', data)
await asyncio.sleep(0.1) # 避免忙等待,给事件循环调度其他任务的机会
except Exception as e:
print(f"后台任务出错: {e}")
await asyncio.sleep(1) # 错误后等待一段时间重试
# 2. 关键修改:使用 asyncio.run 作为线程目标,并将协程作为 args 传递
background_thread = threading.Thread(target=asyncio.run, args=(background_task,))
background_thread.daemon = True # 设置为守护线程,主程序退出时自动终止
background_thread.start()
print("后台线程已启动。")
# 运行 ASGI 应用 (例如使用 uvicorn)
# if __name__ == "__main__":
# import uvicorn
# print("主应用启动...")
# uvicorn.run(app, host="0.0.0.0", port=8000)在Python asyncio应用中,当需要在一个独立的后台线程中运行一个async协程时,核心要点是确保该协程在一个事件循环中被await。通过将asyncio.run()函数作为threading.Thread的目标,并把你的协程作为其参数,可以为后台协程创建一个独立的事件循环,从而避免RuntimeWarning并实现任务的正确执行,同时不阻塞主应用的事件循环。这种模式在处理需要持续运行的后台I/O密集型异步任务时尤其有用。
以上就是Python asyncio应用中后台协程任务的正确运行姿势的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号