如何为GitLab CI流水线添加模拟麦克风与扬声器以运行pytest测试？

当然可以通过添加虚拟音频设备或mock依赖的方式解决这个问题，以下是两种可行方案：

方案一：在GitLab CI环境中配置虚拟音频设备 #

GitLab Runner通常运行在无头Linux环境中，没有默认音频设备，可通过PulseAudio创建虚拟的输入/输出设备：

1. 在CI配置文件（.gitlab-ci.yml）的测试job中，先安装并启动PulseAudio：

test:
  image: python:3.10-slim
  before_script:
    - apt-get update && apt-get install -y pulseaudio
    - pulseaudio --start
    - pactl load-module module-null-sink sink_name=virtual_sink
    - pactl load-module module-null-source source_name=virtual_source
    - pactl set-default-sink virtual_sink
    - pactl set-default-source virtual_source
    - pip install -r requirements.txt
  script:
    - pytest tests/

2. 上述命令会创建无实际输出/输入的虚拟音频设备，并设置为系统默认，这样pyaudio.PyAudio()就能正常初始化，测试可顺利执行。

方案二：在测试代码中Mock PyAudio模块 #

如果不需要验证真实的音频硬件交互，直接在测试层面对PyAudio进行mock更轻量，无需修改CI环境配置：

以pytest-mock为例，修改测试文件：

from unittest.mock import Mock
from your_audio_module import AudioPlayer, AudioRecorder

def test_audio_player(mocker):
    # Mock PyAudio类及相关方法
    mock_pyaudio = mocker.patch('pyaudio.PyAudio')
    mock_stream = Mock()
    mock_pyaudio.return_value.open.return_value = mock_stream

    # 执行测试逻辑
    player = AudioPlayer()
    player.play()

    # 验证关键调用是否触发
    mock_pyaudio.assert_called_once()
    mock_stream.start_stream.assert_called()
    mock_pyaudio.return_value.terminate.assert_called()

def test_audio_recorder(mocker):
    mock_pyaudio = mocker.patch('pyaudio.PyAudio')
    mock_stream = Mock()
    mock_pyaudio.return_value.open.return_value = mock_stream
    # 模拟录制返回空音频数据
    mock_stream.read.return_value = b''

    recorder = AudioRecorder()
    recorded_data = recorder.record()

    mock_pyaudio.assert_called_once()
    mock_stream.read.assert_called()
    mock_pyaudio.return_value.terminate.assert_called()

这种方式直接跳过真实的音频设备初始化，只验证业务代码对音频API的调用逻辑，适合快速适配CI环境。

方案选择 #

• 若测试需要验证音频编码/解码等核心逻辑，选择虚拟设备方案；
• 若仅需验证业务流程（如API调用正确性），选择Mock方案更高效。

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