Docker环境下Pjsua2 AudioMediaPlayer通话播放Wav无声音问题排查

核心问题根源 #

Python的垃圾回收（GC）机制会自动清理没有被任何变量引用的对象。如果你的AudioMediaPlayer实例只是在局部函数里创建，没有被绑定到全局变量、类成员这类长期存在的存储容器，函数执行完毕后，这个实例就会被GC立即回收，底层音频资源也会被释放，自然就没声音了。

排查步骤 #

• 查作用域：确认AudioMediaPlayer是在局部函数内创建还是全局/类属性里。局部变量的话，函数跑完就没了，必然被回收。
• 对日志时间：看创建和销毁日志的时间差，如果刚好是函数执行结束的节点，百分百是GC的锅。
• 顺带查Docker音频配置：虽然核心是对象生命周期，但也要确认容器有没有映射音频设备（比如启动时加--device /dev/snd），不过从你的日志情况看，这个不是主要问题。

解决办法 #

1. 把播放器实例存为全局变量 #

在模块顶部声明一个全局变量，专门存播放器实例，保证通话全程有引用：

# 全局存储，避免被GC回收
active_player = None

def initiate_call():
    global active_player
    # 创建播放器并关联媒体流
    active_player = pj.AudioMediaPlayer()
    active_player.createPlayer("/container/path/to/audio.wav")
    call_media = active_call.getAudioMedia(-1)
    active_player.startTransmit(call_media)

2. 绑定到通话类的成员属性 #

如果用类封装通话逻辑，直接把播放器作为类的成员变量，只要通话对象存在，播放器就不会被回收：

class SIPCall(pj.Call):
    def __init__(self, account, call_id=pj.PJSUA_INVALID_ID):
        super().__init__(account, call_id)
        self.audio_player = None  # 预留播放器存储位置

    def onCallState(self, param):
        call_info = self.getInfo()
        # 通话建立后初始化播放器
        if call_info.state == pj.PJSIP_INV_STATE_CONFIRMED:
            self.audio_player = pj.AudioMediaPlayer()
            self.audio_player.createPlayer("/container/path/to/audio.wav")
            media_stream = self.getAudioMedia(-1)
            self.audio_player.startTransmit(media_stream)

3. 临时禁用GC（不推荐） #

如果赶时间应急，可以临时禁止GC回收，但这种方法不够规范，优先用前两种：

import gc

def make_call():
    player = pj.AudioMediaPlayer()
    player.createPlayer("/container/path/to/audio.wav")
    # 临时禁用GC，避免回收播放器
    gc.disable()
    # 关联媒体流逻辑...

额外验证项 #

• 确认音频文件路径：Docker里要用容器内部的绝对路径，别用宿主机的路径，除非你挂载了对应目录。
• 检查Pjsua2音频配置：初始化时可以关闭音频设备自动关闭，避免意外释放资源：

ep_config = pj.EpConfig()
ep_config.audioConfig.devConfig.sndAutoClose = False
ep.init(ep_config)

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