树莓派使用USB PnP声卡作为麦克风时，如何修复ALSA"无法找到定义"错误？

问题描述 #

• 运行以下Python语音识别代码时触发ALSA错误：

import speech_recognition as sr
from datetime import date
from time import sleep
r = sr.Recognizer()
mic = sr.Microphone()

• 报错信息：

ALSA lib confmisc.c:1281:(snd_func_refer) Unable to find definition 'cards.bcm2835_hdmi.pcm.front.0:CARD=0'

• 已完成的检查：
  • 桌面扬声器图标右键菜单中，音频输入已显示为「USB PnP Sound Device」
  • 确认.asoundrc、asound.config配置正确
  • ALSAMixer配置正常

修复步骤 #

1. 确认USB麦克风的声卡编号 #

先执行命令查看系统识别的音频设备，找到USB麦克风对应的card编号（通常内置HDMI声卡为0，USB设备为1）：

arecord -l

2. 强制指定默认音频设备 #

编辑ALSA全局配置文件，将默认设备指向USB麦克风：

sudo nano /usr/share/alsa/alsa.conf

修改以下两行内容（将1替换为你查到的USB声卡编号）：

defaults.ctl.card 1
defaults.pcm.card 1

保存退出（按Ctrl+O回车，再按Ctrl+X）。

3. 重置自定义ALSA配置 #

如果之前的自定义配置存在冲突，先备份再重建：

# 备份用户配置文件
mv ~/.asoundrc ~/.asoundrc.bak
# 备份系统配置文件
sudo mv /etc/asound.conf /etc/asound.conf.bak

创建新的用户配置文件，指定USB麦克风为默认设备：

echo 'pcm.!default {
    type hw
    card 1
}
ctl.!default {
    type hw
    card 1
}' > ~/.asoundrc

4. 重启音频服务或系统 #

执行命令重启ALSA服务：

sudo alsa force-reload

如果问题仍存在，直接重启树莓派：

sudo reboot

5. 在Python代码中指定麦克风设备 #

避免自动识别出错，在代码里明确指定USB麦克风的设备编号：

import speech_recognition as sr
from datetime import date
from time import sleep

r = sr.Recognizer()
# 列出所有可用麦克风，确认USB设备的编号
for index, name in enumerate(sr.Microphone.list_microphone_names()):
    print(f"麦克风设备 {index}: {name}")
# 替换为你的USB麦克风编号
mic = sr.Microphone(device_index=1)

内容的提问来源于stack exchange，提问作者Wally