在Django中使用FFmpeg提取上传视频的WAV音频及存储问题

Hey there! Let's break down how to solve your problem step by step—since you've already tried a couple approaches, let's fix those issues and get your audio extraction working properly.

一、先理清你之前遇到的问题 #

• Django-ffmpeg的「pending conversion」提示，通常是因为异步任务依赖（比如Celery）没配置启动，如果你不想依赖第三方库，直接用subprocess是更直接的方案，但你的代码存在几个关键问题。
• 你的验证脚本里有重复的代码逻辑，而且把音频转换放在验证函数里是不合理的——验证函数只负责检查文件格式，转换操作应该放在文件成功保存后的逻辑里。

二、正确的实现步骤 #

1. 确定音频文件的存储位置 #

在Django中，推荐把提取后的WAV文件存在MEDIA_ROOT目录下的子文件夹（比如media/audio_extracts/）。这样既可以和用户上传的原始视频文件分开管理，也符合Django媒体文件的规范。

首先确保你在settings.py里已经配置好媒体文件路径：

import os
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
MEDIA_URL = '/media/'

2. 修复文件上传与转换逻辑 #

不要在验证函数里执行转换，而是把逻辑放在模型的save()方法或者视图的文件处理流程中。下面是一个完整的示例：

第一步：定义视频上传模型

from django.db import models
import os
import subprocess
from django.conf import settings

class UploadedVideo(models.Model):
    video_file = models.FileField(upload_to='videos/', validators=[validate_file_extension])
    audio_file = models.FileField(upload_to='audio_extracts/', blank=True, null=True)

    def save(self, *args, **kwargs):
        # 先保存原始视频文件，确保文件已写入磁盘
        super().save(*args, **kwargs)
        
        # 仅当音频文件未生成时执行转换
        if self.video_file and not self.audio_file:
            # 获取原始视频的绝对路径
            input_path = self.video_file.path
            # 生成WAV文件的存储路径：沿用原文件名，替换后缀为.wav
            filename = os.path.splitext(os.path.basename(input_path))[0]
            output_path = os.path.join(settings.MEDIA_ROOT, 'audio_extracts', f'{filename}.wav')
            
            # 执行FFmpeg转换：用参数列表传参更安全（避免路径含空格或shell注入）
            subprocess.run([
                'ffmpeg',
                '-i', input_path,
                '-vn',  # 忽略视频流，只提取音频
                '-acodec', 'pcm_s16le',  # 标准WAV无损编码
                '-ar', '44100',  # 设置采样率
                '-ac', '2',  # 设置声道数
                output_path
            ], check=True)
            
            # 更新模型的音频文件字段
            relative_path = os.path.relpath(output_path, settings.MEDIA_ROOT)
            self.audio_file = relative_path
            # 再次保存模型，写入音频文件路径到数据库
            super().save(*args, **kwargs)

第二步：修复文件格式验证函数

验证函数只负责检查文件后缀，移除多余的转换逻辑：

from django.core.exceptions import ValidationError
import os

def validate_file_extension(value):
    ext = os.path.splitext(value.name)[1].lower()
    valid_extensions = ['.mp4']
    if ext not in valid_extensions:
        raise ValidationError('Unsupported file extension. Only MP4 files are allowed.')

3. 关键注意事项 #

• subprocess的正确用法：用subprocess.run()替代subprocess.call()，并且传递参数列表而非字符串——这样能避免路径含空格时的错误，也更安全。添加check=True可以在FFmpeg执行失败时抛出异常，方便调试。
• FFmpeg参数优化：-vn参数能让FFmpeg只处理音频流，大幅提升转换速度；指定pcm_s16le编码能生成兼容所有设备的标准WAV文件。
• 权限问题：确保Django运行的用户对MEDIA_ROOT/audio_extracts/文件夹有读写权限，否则FFmpeg无法生成文件。
• 大文件处理：如果用户上传的视频很大，同步转换会导致请求超时，建议用Celery将转换任务放到异步队列中，避免阻塞用户请求。

三、为什么你之前的代码没生效？ #

• 你写的subprocess.call('ffmpeg -i filename.mp4 filename.wav')里的filename.mp4是硬编码字符串，不是用户上传的实际文件名，导致FFmpeg找不到目标文件。
• 把转换逻辑放在验证函数里是错误的——验证阶段文件还只是临时文件，并未保存到磁盘，FFmpeg无法访问到它。

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