如何在Python异步应用中解决同步cv2视频录制的事件循环阻塞问题
问题核心原因拆解
- 之前尝试的线程池方案失效的第一个关键点:用带
with上下文的临时线程池跑录制任务时,上下文退出节点会阻塞等待池内所有任务执行完成才返回,相当于原本要后台跑的录制流程被强制同步等待,自然会阻塞事件循环。 - 第二个失效点:
recording函数是无休眠的死循环,OpenCV的帧读、写操作是同步IO,会把专属线程的CPU时间片占满,操作系统调度优先级上和事件循环线程无隔离,表现出来就是整个程序卡着不响应异步逻辑。 - 第三个预期异常的根因:线程池仅支持调度普通同步函数,直接把async协程塞进执行队列,协程对象根本没有被事件循环接管执行,自然会抛出“coroutine was never awaited”的报错。
- 额外的资源问题:全局域定义的摄像头、视频写入器对象没有生命周期管理,多流程操作时容易出现资源提前释放、读写冲突的问题。
可直接落地的改造方案
- 为录制流程单独绑定一个常驻的单线程线程池,不要每次触发录制都新建/销毁线程池,更不要用会阻塞等待任务完成的
with上下文管理方式。 - 触发录制时采用“丢任务不等待”的模式:通过
loop.run_in_executor把同步录制函数丢进专属线程池后立刻返回协程结果,不要await等待录制任务跑完。 - 给录制循环加极短的休眠间隙(比如
time.sleep(0.01)),主动让出CPU调度时间,避免线程被OpenCV的同步IO占满。 - 把摄像头、视频写入器的资源从全局域挪到类内部做生命周期管理,录制开始时初始化资源,检测到停止标志位后自动释放资源。
- 停止录制时仅修改类内部的停止标志位即可,不需要主动给录制线程发中断信号,等录制循环轮询到标志位变更后自动退出。
改造后的核心示例代码
import time import asyncio import concurrent.futures from cv2 import cv2 as cv class CameraControls(object): def __init__(self): self.flag = True # 专属常驻线程池,仅用于跑录制任务,和其他业务线程隔离 self.record_executor = concurrent.futures.ThreadPoolExecutor(max_workers=1) self.cam = None self.video_writer = None def _init_camera_resource(self): """录制开始前初始化摄像头、视频写入器""" self.cam = cv.VideoCapture(0) frame_width = int(self.cam.get(cv.CAP_PROP_FRAME_WIDTH) + 0.5) frame_height = int(self.cam.get(cv.CAP_PROP_FRAME_HEIGHT) + 0.5) frame_size = (frame_width, frame_height) fourcc = cv.VideoWriter_fourcc(*'XVID') self.video_writer = cv.VideoWriter('output.avi', fourcc, 10.0, frame_size, 1) def recording_loop(self): """同步录制循环,跑在专属线程里""" self._init_camera_resource() while True: ret, frame = self.cam.read() if not ret: break self.video_writer.write(frame) # 10ms休眠让出CPU,避免线程占满调度 time.sleep(0.01) if not self.flag: break # 自动释放硬件、文件资源 self.cam.release() self.video_writer.release() cv.destroyAllWindows() async def start_recording(self): """异步触发录制,不阻塞事件循环""" self.flag = True loop = asyncio.get_event_loop() # 直接丢任务到专属线程池,不await等待任务完成 loop.run_in_executor(self.record_executor, self.recording_loop) async def stop_recording(self): """异步停止录制,仅修改状态标志""" self.flag = False
补充注意点:
- 不要用默认的全局线程池跑长耗时的录制任务:Python默认全局线程池有最大线程数限制,录制任务长期占住线程会导致其他同步业务任务排队,出现事件循环响应变慢的假象。
- 原代码里的
async with open()、requests.post()都是同步阻塞逻辑,实际跑的时候也会卡事件循环:读视频文件换用aiofiles,发HTTP请求要么丢进线程池,要么换成异步HTTP客户端库。
内容的提问来源于stack exchange,提问作者Oleg Kotov
相关产品推荐
相关产品推荐

