Django视图中调用VLC播放音频无报错却失败的问题求助

我用树莓派连接门铃传感器，实现人员进入时播放不同音效，直接用脚本读取目录音频能正常运行。为了方便上传音效和排序，用Django搭了Web服务。一段调用VLC播放音频的代码在Django交互控制台能正常跑，但在视图的PUT请求里调用时，没报错却完全没声音，本地电脑和树莓派上都有这个问题。

测试代码：

>>> import vlc
>>> media_player = vlc.MediaPlayer()
>>> media = vlc.Media("/home/pi/chime/media/clips/clip1.mp3")
>>> media_player.set_media(media)
>>> media_player.play()

Django视图代码示例：

class ClipsList(View):
    template_name = "clips/clip_list.html"

    # Ensure we have a CSRF cooke set
    @method_decorator(ensure_csrf_cookie)
    def get(self, request):
        ctx = {
            'object_list': Clip.objects.all().order_by('order'),
        }
        return render(self.request, self.template_name, context=ctx)

    # Process POST AJAX Request
    def post(self, request):
        if request.headers.get('x-requested-with') == 'XMLHttpRequest':
            try:
                # Parse the JSON payload
                data = json.loads(request.body)[0]
                # Loop over our list order. The id equals the question id. Update the order and save
                for idx, row in enumerate(data):
                    pq = Clip.objects.get(pk=row['id'])
                    pq.order = idx + 1
                    pq.save()

            except KeyError:
                HttpResponse(status="500", content="Malformed Data!")

            return JsonResponse({"success": True}, status=200)
        else:
            return JsonResponse({"success": False}, status=400)

    def put(self, request, pk):
        if request.headers.get('x-requested-with') == 'XMLHttpRequest':
            try:
                data = json.loads(request.body)
                clip = Clip.objects.get(pk=pk)
                media_player = vlc.MediaPlayer()
                media = vlc.Media(os.path.join(settings.BASE_DIR, str(clip.file)))
                media_player.set_media(media)
                media_player.play()
                sleep(3)
                media_player.stop()

            except KeyError:
                HttpResponse(status="500", content="Malformed Data!")
            return JsonResponse({"success": True}, status=200)
        else:
            return JsonResponse({"success": False}, status=400)

1. Web进程音频上下文缺失：Django运行在Gunicorn、uWSGI这类Web服务器进程中，这些进程默认没有绑定用户会话的音频环境变量（比如ALSA配置、音频设备访问权限），而控制台运行时处于当前用户的完整会话，能正常访问音频输出设备。
2. VLC实例生命周期问题：即便加了sleep(3)，视图函数执行完成后，Web服务器可能会回收当前请求的线程/进程，导致VLC的MediaPlayer对象被提前销毁，音频还未播放就被终止。
3. 权限不足：Web服务器的运行用户（比如树莓派上的www-data）可能没有访问音频设备的权限，或者没有读取音频文件的权限。
4. VLC初始化参数缺失：在视图中创建VLC实例时，未指定音频输出模块或设备，导致VLC无法找到有效的音频输出路径。

方法1：改用后台线程执行音频播放 #

把音频播放逻辑放到后台线程，避免阻塞视图，同时保证播放进程不会随视图请求结束而被销毁：

import threading
import vlc
import os
from django.conf import settings

def play_audio(clip_path):
    media_player = vlc.MediaPlayer()
    media = vlc.Media(clip_path)
    media_player.set_media(media)
    # 手动指定音频输出模块，比如ALSA
    media_player.audio_set_output("alsa")
    media_player.play()
    # 等待播放完成
    while media_player.is_playing():
        continue
    media_player.stop()

# 在PUT视图中调用
def put(self, request, pk):
    if request.headers.get('x-requested-with') == 'XMLHttpRequest':
        try:
            data = json.loads(request.body)
            clip = Clip.objects.get(pk=pk)
            clip_path = os.path.join(settings.BASE_DIR, str(clip.file))
            # 启动后台线程播放
            threading.Thread(target=play_audio, args=(clip_path,), daemon=True).start()
        except KeyError:
            return HttpResponse(status=500, content="Malformed Data!")
        return JsonResponse({"success": True}, status=200)
    else:
        return JsonResponse({"success": False}, status=400)

方法2：使用轻量音频工具替代VLC #

用mpg123（针对MP3）或aplay（针对WAV）这类命令行工具，通过subprocess调用，比VLC更适合服务器环境：

import subprocess
import os
from django.conf import settings

def put(self, request, pk):
    if request.headers.get('x-requested-with') == 'XMLHttpRequest':
        try:
            data = json.loads(request.body)
            clip = Clip.objects.get(pk=pk)
            clip_path = os.path.join(settings.BASE_DIR, str(clip.file))
            # 用mpg123后台播放MP3，-q参数关闭输出
            subprocess.Popen(["mpg123", "-q", clip_path])
        except KeyError:
            return HttpResponse(status=500, content="Malformed Data!")
        return JsonResponse({"success": True}, status=200)
    else:
        return JsonResponse({"success": False}, status=400)

注意：树莓派上需先安装工具，执行sudo apt-get install mpg123。

方法3：给Web服务器用户添加音频权限 #

把Web服务器运行用户加入audio组，让它能访问音频设备：

sudo usermod -aG audio www-data

之后重启Web服务器（比如sudo systemctl restart gunicorn）。

方法4：配置Web服务器的音频环境 #

如果坚持用VLC，需要给Web服务器进程设置音频环境变量，比如在Gunicorn的启动脚本中添加：

export ALSA_CONFIG_PATH=/usr/share/alsa/alsa.conf
export DISPLAY=:0

或者在Django的settings.py中手动设置：

import os
os.environ['ALSA_CONFIG_PATH'] = '/usr/share/alsa/alsa.conf'
os.environ['DISPLAY'] = ':0'

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