树莓派3B播放WAV音频时Python进程异常退出码-11问题排查

退出码-11的含义 #

退出码-11对应段错误（Segmentation Fault），本质是程序尝试访问了不属于自身的内存空间，或是对只读内存执行了写入操作，导致系统强制终止进程。在树莓派这类嵌入式设备上，常见于音频库内存操作异常、资源释放不当或硬件兼容性问题。

代码问题分析 #

你的代码里有几个核心问题会触发这类错误：

1. 文件流过早关闭：PlaySound函数中用with open打开WAV文件，但pygame.mixer.music.load()仅读取文件流引用，并未立即把音频数据全部加载到内存。with代码块结束后文件流会自动关闭，pygame后续播放时访问已失效的资源，直接引发内存访问错误。
2. 缺少pygame mixer初始化（推测）：如果程序开头没有正确初始化音频模块（设置采样率、声道数等参数），底层音频驱动可能崩溃触发段错误。
3. GPIO防抖逻辑不完善：简单的time.sleep(0.5)防抖可能失效，频繁触发播放请求会导致音频资源冲突。

修复方案 #

1. 修复文件流问题（核心） #

直接让pygame加载文件路径（推荐），避免手动管理文件流导致的提前关闭问题：

def PlaySound(file):
    pygame.mixer.music.load(Path + file)
    pygame.mixer.music.play(loops=0, start=0.0, fade_ms=0)
    while pygame.mixer.music.get_busy():
        continue

如果必须使用文件流，要确保播放完成后再关闭：

def PlaySound(file):
    WaveFileRB = open(Path + file, "rb")
    pygame.mixer.music.load(WaveFileRB)
    pygame.mixer.music.play(loops=0, start=0.0, fade_ms=0)
    while pygame.mixer.music.get_busy():
        continue
    WaveFileRB.close()  # 播放结束后再关闭文件

2. 正确初始化pygame与GPIO #

在程序开头添加完整的初始化代码，匹配音频文件的参数（以常见的44100Hz采样率、16位双声道为例）：

import pygame
import RPi.GPIO as GPIO
import random
import time

Path = "./sounds/"  # 替换为你的音频文件路径
ButtonPin = 3
SoundFiles = ["sound1.wav", "sound2.wav"]  # 替换为你的音频文件名列表

# 初始化pygame音频模块
pygame.mixer.init(frequency=44100, size=-16, channels=2, buffer=4096)
# 初始化GPIO
GPIO.setmode(GPIO.BCM)
GPIO.setup(ButtonPin, GPIO.IN, pull_up_down=GPIO.PUD_UP)

3. 优化GPIO触发逻辑 #

改用GPIO事件检测代替轮询，避免重复触发：

def on_button_press(channel):
    # 二次防抖
    time.sleep(0.2)
    if GPIO.input(channel) == GPIO.LOW:
        File = random.choice(SoundFiles)
        PlaySound(File)

# 注册GPIO下降沿触发事件，设置300ms防抖
GPIO.add_event_detect(ButtonPin, GPIO.FALLING, callback=on_button_press, bouncetime=300)

# 主循环维持程序运行
try:
    while True:
        time.sleep(1)
except KeyboardInterrupt:
    GPIO.cleanup()
    pygame.mixer.quit()

4. 额外排查点 #

• 检查WAV文件格式：确保是pygame支持的PCM编码，采样率、声道数与初始化参数匹配，损坏或不兼容的音频文件也会触发段错误。
• 更新系统与库：执行sudo apt update && sudo apt upgrade -y更新树莓派系统，再用pip install --upgrade pygame升级pygame。
• 测试硬件：用aplay test.wav命令测试系统层面能否播放音频，排除音频输出硬件故障。

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