Django中使用Pydub转换音频为AAC格式时编码失败求助

问题场景 #

在Django Admin表单接收音频输入，尝试通过pydub将其转换为AAC格式。系统已安装ffmpeg，且添加了pydub和ffmpeg-python作为依赖，但转换MP3文件为AAC格式时出现编码失败错误。

原ModelAdmin代码 #

class AudioAdmin(admin.ModelAdmin):
    fields = ('file', 'bit_rate', 'format')
    list_display = ('id', 'file', 'bit_rate', 'format', 'content_type')

    def save_model(self, request, obj, form, change):
        audio_file = form.cleaned_data['file']
        _, file_extension = os.path.splitext(audio_file.name)
        curr_audio = AudioSegment.from_file(file=audio_file, format=file_extension.replace('.', ''))
        new_audio = curr_audio.export(out_f=audio_file.name, format="aac")
        obj.file = new_audio
        obj.save()

错误信息 #

raise CouldntEncodeError(
pydub.exceptions.CouldntEncodeError: Encoding failed. ffmpeg/avlib returned error code: 1
Command:['ffmpeg', '-y', '-f', 'wav', '-i', '/var/folders/8g/230x9vx55p7c0bdwx0cmzx9r0000gq/T/tmpxaetjjk0', '-f', 'aac', '/var/folders/8g/230x9vx55p7c0bdwx0cmzx9r0000gq/T/tmpa3ae8nn1']
Output from ffmpeg/avlib:
ffmpeg version 6.0 Copyright (c) 2000-2023 the FFmpeg developers
  built with Apple clang version 14.0.0 (clang-1400.0.29.202)
  configuration: --prefix=/usr/local/Cellar/ffmpeg/6.0 --enable-shared --enable-pthreads --enable-version3 --cc=clang --host-cflags= --host-ldflags= --enable-ffplay --enable-gnutls --enable-gpl --enable-libaom --enable-libaribb24 --enable-libbluray --enable-libdav1d --enable-libmp3lame --enable-libopus --enable-librav1e --enable-librist --enable-librubberband --enable-libsnappy --enable-libsrt --enable-libsvtav1 --enable-libtesseract --enable-libtheora --enable-libvidstab --enable-libvmaf --enable-libvorbis --enable-libvpx --enable-libwebp --enable-libx264 --enable-libx265 --enable-libxml2 --enable-libxvid --enable-lzma --enable-libfontconfig --enable-libfreetype --enable-frei0r --enable-libass --enable-libopencore-amrnb --enable-libopencore-amrwb --enable-libopenjpeg --enable-libspeex --enable-libsoxr --enable-libzmq --enable-libzimg --disable-libjack --disable-indev=jack --enable-videotoolbox --enable-audiotoolbox
  libavutil      58.  2.100 / 58.  2.100
  libavcodec     60.  3.100 / 60.  3.100
  libavformat    60.  3.100 / 60.  3.100
  libavdevice    60.  1.100 / 60.  1.100
  libavfilter     9.  3.100 /  9.  3.100
  libswscale      7.  1.100 /  7.  1.100
  libswresample   4. 10.100 /  4. 10.100
  libpostproc    57.  1.100 / 57.  1.100
Guessed Channel Layout for Input Stream #0.0 : stereo
Input #0, wav, from '/var/folders/8g/230x9vx55p7c0bdwx0cmzx9r0000gq/T/tmpxaetjjk0':
  Duration: 00:03:14.72, bitrate: 1411 kb/s
  Stream #0:0: Audio: pcm_s16le ([1][0][0][0] / 0x0001), 44100 Hz, 2 channels, s16, 1411 kb/s
[NULL @ 0x7fe40da072c0] Requested output format 'aac' is not a suitable output format
/var/folders/8g/230x9vx55p7c0bdwx0cmzx9r0000gq/T/tmpa3ae8nn1: Invalid argument

错误原因 #

1. 容器格式混淆：aac是音频编码格式，不是ffmpeg可识别的输出容器格式，直接指定format="aac"会导致ffmpeg无法确定输出容器类型，引发错误。
2. 文件对象处理不当：直接将pydubexport返回的文件对象赋值给Django的FileField，不符合Django对文件对象的要求，可能导致文件保存异常。

修复后的代码 #

import os
from io import BytesIO
from django.core.files.base import ContentFile
from pydub import AudioSegment
from django.contrib import admin
from .models import Audio  # 替换为你的Audio模型类

class AudioAdmin(admin.ModelAdmin):
    fields = ('file', 'bit_rate', 'format')
    list_display = ('id', 'file', 'bit_rate', 'format', 'content_type')

    def save_model(self, request, obj, form, change):
        audio_file = form.cleaned_data['file']
        # 获取原文件格式，默认设为mp3
        _, file_extension = os.path.splitext(audio_file.name)
        input_format = file_extension.replace('.', '') if file_extension else 'mp3'

        # 重置文件指针到开头，确保pydub能完整读取文件
        audio_file.seek(0)
        curr_audio = AudioSegment.from_file(file=audio_file, format=input_format)

        # 使用BytesIO在内存中处理转换后的音频，避免临时文件问题
        output_buffer = BytesIO()
        # 用adts容器输出AAC编码音频，若需要MP4容器可替换为format="mp4"
        curr_audio.export(
            output_buffer,
            format="adts",
            codec="aac",
            bitrate=form.cleaned_data.get('bit_rate', '128k')
        )
        output_buffer.seek(0)

        # 生成新文件名，替换原扩展名为.aac
        new_filename = os.path.splitext(audio_file.name)[0] + '.aac'
        # 转换为Django可识别的ContentFile对象
        obj.file = ContentFile(output_buffer.read(), name=new_filename)
        # 更新格式和比特率字段
        obj.format = 'aac'
        obj.bit_rate = form.cleaned_data.get('bit_rate', '128k')

        # 调用父类方法完成保存
        super().save_model(request, obj, form, change)

关键修复点 #

• 容器格式修正：使用format="adts"（AAC裸流常用容器）或format="mp4"作为输出容器，配合codec="aac"指定编码格式，解决ffmpeg的容器识别问题。
• 内存文件处理：用BytesIO和ContentFile封装转换后的音频数据，符合DjangoFileField的要求，同时避免临时文件的管理问题。
• 文件指针重置：添加audio_file.seek(0)确保pydub能完整读取上传的文件（表单处理后文件指针可能停留在末尾）。
• 字段同步更新：手动同步format和bit_rate字段值，确保与转换后的音频属性一致。

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