Docker镜像运行SpeechRecognition语音识别报ALSA找不到声卡0错误

问题原因 #

报错本质是Docker容器默认未挂载宿主机音频设备，且容器内运行用户无音频设备访问权限，仅安装alsa依赖、开启特权模式无法解决。

解决方案 #

1. 调整容器启动参数 #

启动容器时添加设备挂载和权限配置，参考启动命令：

docker run -d --privileged \
  -v /dev/snd:/dev/snd \
  -v /etc/asound.conf:/etc/asound.conf \
  -v /usr/share/alsa:/usr/share/alsa \
  --group-add audio \
  -p 5000:5000 \
  <你的镜像名称>

参数说明：

• -v /dev/snd:/dev/snd：将宿主机声卡设备挂载到容器内
• --group-add audio：给容器内运行用户添加audio用户组权限，获得音频设备访问资格
• 另外两个挂载项为同步宿主机ALSA音频配置，避免配置不兼容问题

2. 修复Dockerfile权限配置（可选） #

你当前Dockerfile使用worker用户运行程序，默认无音频设备访问权限，可以直接在Dockerfile中提前将worker加入audio组，避免每次启动都加--group-add参数：
在RUN useradd -m worker行后新增：

RUN usermod -aG audio worker

重新构建镜像即可。

3. 确认宿主机前置条件 #

启动容器前先在宿主机执行arecord -l，确认能正常输出声卡设备列表。如果宿主机本身无硬件声卡（如云服务器），无法直接使用后端调用麦克风的方案，可选择外接USB声卡，或修改逻辑为前端页面采集音频流后传到后端识别。

补充：容器内lspci无输出属于正常情况，Docker默认不会挂载pci相关的系统文件，和声卡识别问题无关。

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