使用Mutagen添加封面后MP3文件无法播放的问题求助

你遇到的核心问题是直接将pytube下载的M4A音频重命名为MP3文件——这只是修改了文件后缀，并没有真正转码为标准MP3格式。M4A属于MP4容器，使用MP4元数据规范，而你用mutagen的ID3（MP3专属标签系统）去修改它，会破坏文件结构，导致文件损坏无法播放。

以下是两种可行的解决思路：

方案1：转码为标准MP3后添加ID3缩略图 #

使用ffmpeg将下载的M4A转码为真正的MP3，再用mutagen添加ID3格式的缩略图：

from os import rename, remove
from os.path import splitext
from pytube import YouTube
from requests import get
from mutagen.mp3 import MP3
from mutagen.id3 import ID3, APIC
import subprocess

link = "你的YouTube视频链接"
download_path = "你的文件保存路径"

yt = YouTube(link)
print('Downloading audio stream...')
# 下载M4A格式的音频流
audio_stream = yt.streams.filter(only_audio=True).first()
download_file = audio_stream.download(output_path=download_path)

# 用ffmpeg转码为高质量MP3
base, _ = splitext(download_file)
out_file = base + '.mp3'
subprocess.run([
    'ffmpeg', '-i', download_file,
    '-codec:a', 'libmp3lame', '-q:a', '2',  # -q:a 2对应高质量MP3
    out_file
], check=True)
# 删除原M4A临时文件
remove(download_file)

# 添加MP3缩略图
thumbnail = get(yt.thumbnail_url).content
audio = MP3(out_file, ID3=ID3)
if not audio.tags:
    audio.add_tags()
audio.tags.add(
    APIC(
        encoding=3,
        mime='image/jpeg',
        type=3,
        desc='Cover',
        data=thumbnail
    )
)
audio.save()

注意：需要先安装ffmpeg，并确保它在系统PATH中，或者在subprocess命令里指定ffmpeg的完整路径。

方案2：保留M4A格式，添加MP4规范缩略图 #

如果不需要MP3格式，可以直接处理M4A文件，用mutagen的MP4模块添加符合MP4规范的封面：

from os import rename
from os.path import splitext
from pytube import YouTube
from requests import get
from mutagen.mp4 import MP4, MP4Cover

link = "你的YouTube视频链接"
download_path = "你的文件保存路径"

yt = YouTube(link)
print('Downloading audio stream...')
audio_stream = yt.streams.filter(only_audio=True).first()
download_file = audio_stream.download(output_path=download_path)

# 确保文件后缀为.m4a（避免格式识别错误）
base, ext = splitext(download_file)
out_file = base + '.m4a'
if download_file != out_file:
    rename(download_file, out_file)

# 添加MP4格式封面
thumbnail = get(yt.thumbnail_url).content
audio = MP4(out_file)
# covr是MP4封面的标准字段，指定图片格式为JPEG
audio['covr'] = [MP4Cover(thumbnail, imageformat=MP4Cover.FORMAT_JPEG)]
audio.save()

这个方案无需转码，文件体积更小，音质损失也更少，适合不需要兼容MP3专属设备的场景。

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