You need to enable JavaScript to run this app. 开发虚拟助手调用Google语音识别接口报UnknownValueError求助
优惠活动
大模型
产品
解决方案
定价
更多

开发虚拟助手调用Google语音识别接口报UnknownValueError求助

报错根因

你碰到的speech_recognition.UnknownValueError触发自speech_recognition库源码858行,当Google语音识别接口没有从上传的音频中返回任何可解析的有效语音候选时,就会抛出该错误,不属于代码语法类崩溃。

按优先级排查修复步骤
  • 增加环境噪音校准逻辑:当前代码没有做麦克风采集阈值适配,直接采集的音频很容易被背景噪音覆盖,导致识别引擎抓不到有效人声。需要在音频采集前增加1秒左右的环境噪音校准,同时给监听动作加合理超时,修改后的采集逻辑参考:
with sr.Microphone() as source:
    # 校准当前环境噪音水平,采集期间保持周边环境和实际使用状态一致
    r.adjust_for_ambient_noise(source, duration=1)
    print("请开始说话")
    # 最长等5秒进入说话状态,单次说话最长识别10秒
    audio = r.listen(source, timeout=5, phrase_time_limit=10)

测试时保持麦克风距嘴部20-30cm,用正常音量说话;校准环境噪音时不要刻意凑麦说话,否则会把识别阈值设得过高,后续正常说话的声音都会被判定为无效噪音。

  • 验证音频采集有效性:Windows环境下speech_recognition有时会默认选中错误的音频输入设备(比如虚拟声卡、禁用的麦克风),导致采集到的音频本身没有有效人声。可以在拿到音频对象后先将内容存为本地wav文件做校验:
# 把采集到的音频存到本地,打开确认是否能清晰听到说话内容
with open("test_recording.wav", "wb") as f:
    f.write(audio.get_wav_data())

如果存出来的文件没有声音、人声过小或全是杂音,就需要在初始化sr.Microphone()时,通过device_index参数指定实际在用的物理麦克风设备索引,不要使用默认设备。

  • 显式指定识别语言:recognize_google接口默认识别语言为英文en-US,如果测试时对着麦克风说中文,接口无法匹配语音内容就会直接抛出识别失败错误。调用识别方法时需要显式传入对应语言参数:
# 说中文就传zh-CN,说英文就传en-US
voice = r.recognize_google(audio, language="zh-CN")
  • 排查网络连通性:Google公开语音识别接口需要稳定可连通的网络环境才能正常访问,如果请求被拦截、超时,接口会返回空的错误响应,最终触发该报错。这种场景下要么配置可正常访问Google服务的网络代理,要么替换为本地运行的语音识别引擎,避免依赖公网接口。

内容的提问来源于stack exchange,提问作者ResulVlnzr

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.18 21:15:05