Windows10 Python3.8.5使用pyttsx3与speech_recognition出现OSError[Errno-9988]报错的原因及解决
Windows环境下语音开发偶发OSError [Errno -9988] Stream closed问题说明
基础场景信息
- 运行环境:Windows 10 操作系统,Python 3.8.5 版本
- 涉及依赖:
speech_recognition语音识别模块、pyttsx3语音合成模块 - 现象描述:程序运行过程中偶发触发
OSError [Errno -9988] Stream closed报错,已通过异常捕获逻辑定位到麦克风读取环节,该错误码对应PyAudio底层依赖的PortAudio库定义的“流已关闭”状态,不属于系统级致命错误 - 参考背景:树莓派环境下存在同类型报错的公开讨论,但未形成有效可落地的修复方案
最小复现代码
import speech_recognition as sr import pyttsx3 engine = pyttsx3.init() while True: r = sr.Recognizer() print("Say something") try: with sr.Microphone() as source: # 注:原始复现代码此处存在缩进缺失,实际运行需对齐块内逻辑 audio = r.listen(source, phrase_time_limit = 10) said = '' try: said = r.recognize_google(audio, language="en-EN") except sr.UnknownValueError: print("Unrecognised speech") if said == 'hi': engine.say("Hello there!") engine.runAndWait() except OSError as ose: print(ose)
报错核心成因
- 音频资源抢占:
speech_recognition底层依赖PyAudio读取麦克风输入流,pyttsx3依赖Windows SAPI引擎输出合成语音,两类音频资源由系统统一调度管理。当TTS引擎正在播放语音时,下一轮循环启动的麦克风采集流可能被系统提前回收,触发流关闭错误。 - 麦克风设备被占用:当系统中其他应用(会议软件、系统语音助手等)同步调用麦克风时,PyAudio获取的采集流会被系统强制断开,后续执行音频读取操作时就会抛出流已关闭的异常。
- TTS引擎句柄泄漏:全局初始化的
pyttsx3实例在多次调用runAndWait()后,会出现内部音频输出句柄未完全释放的问题,累积的未释放句柄会阻塞系统音频接口调用,最终导致麦克风采集流创建失败。 - 流生命周期校验缺失:每轮循环重新创建
sr.Recognizer实例时,未对已建立的麦克风流做状态校验,在设备唤醒延迟、采集超时等场景下,会出现流提前关闭但程序仍尝试读取音频的情况。 - 代码结构不规范:复现代码中
with sr.Microphone()块内逻辑缩进缺失,会导致上下文提前退出、流被强制释放,触发偶发报错。
可行解决方法
- 调整调用时序:TTS引擎完成语音播放后,增加100ms-300ms的等待间隔,待系统完成音频会话切换、释放麦克风采集权限后,再启动下一轮麦克风监听流程,从根源避免资源抢占。
- 修复句柄泄漏:每次调用
engine.runAndWait()完成语音播放后,显式执行engine.stop()重置引擎状态;避免全程复用全局初始化的TTS实例,按需创建、销毁引擎对象,减少长期句柄占用。 - 增加重试逻辑:捕获
OSError [Errno -9988]报错后,间隔200ms重新尝试初始化麦克风流;连续3次重试失败时,提示用户检查麦克风连接状态、关闭其他占用麦克风的应用。 - 固定采集设备:初始化
sr.Microphone时显式指定可用的设备索引,避免系统默认音频设备偶发切换,导致采集流绑定到无效设备。 - 规范代码结构:保证
with sr.Microphone()上下文块内的所有逻辑缩进对齐,避免上下文提前退出、流被提前释放的问题。
内容的提问来源于stack exchange,提问作者user14023416
相关产品推荐
相关产品推荐

