自制YouTube视频转MP3下载器下载失败，请求技术支援

核心问题排查 #

1. MP3格式流获取失败 #

YouTube本身不提供原生MP3音频流，你指定preftype="mp3"时，Pafy大概率找不到匹配的音频源，导致bestaudio为None，后续下载逻辑直接崩溃。

2. 未处理无效路径场景 #

如果用户未点击「Select Path」选择下载目录，user_path会是默认的标签文本（"Select Path For Download"），这不是合法的系统路径，执行shutil.move时会抛出文件路径不存在的异常。

3. Pafy版本过时 #

Pafy项目已停止维护多年，YouTube的API结构频繁更新，旧版本Pafy无法解析当前的视频链接，导致获取视频元数据失败。

4. 文件名特殊字符冲突 #

视频标题可能包含斜杠、冒号、星号等系统禁止的特殊字符，直接用作文件名会导致文件移动操作失败。

针对性修复方案 #

1. 调整音频格式处理逻辑 #

放弃直接指定MP3，先获取最佳质量的音频流，再通过重命名或转换得到MP3文件：

import os  # 需要新增导入

def download_video():
    get_link = link_field.get()
    user_path = path_label.cget("text")
    screen.title('Downloading...')

    try:
        video = pafy.new(get_link)
        bestaudio = video.getbestaudio()  # 不限制格式，先获取最佳音频
        download_result = bestaudio.download()

        if download_result:
            # 处理格式转换：如果原格式不是MP3，重命名为MP3
            original_ext = bestaudio.extension
            filename = download_result
            if original_ext != 'mp3':
                new_filename = filename.replace(f'.{original_ext}', '.mp3')
                os.rename(filename, new_filename)
                filename = new_filename
            
            # 清理标题中的非法字符
            clean_title = bestaudio.title.replace('/', '').replace('\\', '').replace(':', '-').replace('*', '').replace('?', '').replace('"', '').replace('<', '').replace('>', '').replace('|', '')
            shutil.move(filename, f"{user_path}/{clean_title}.mp3")
            screen.title('Download Complete! Download Another Video...')
        else:
            screen.title('Failed to Download Video...')
            raise Exception("下载未返回有效文件名")
    except Exception as e:
        screen.title('Failed to Download Video...')
        print(f"下载错误: {e}")

2. 增加路径有效性校验 #

在下载函数开头添加路径检查，避免无效路径导致的错误：

def download_video():
    get_link = link_field.get()
    user_path = path_label.cget("text")
    
    # 检查路径是否有效
    if user_path == "Select Path For Download" or not os.path.isdir(user_path):
        screen.title('请选择有效的下载路径')
        return
    
    # 后续下载逻辑...

3. 替换为维护活跃的库（推荐） #

由于Pafy已废弃，建议改用yt-dlp（yt-dl的官方分支，持续更新），它能自动处理音频格式转换：

• 安装依赖：pip install yt-dlp ffmpeg-python
• 替换下载函数示例：

import yt_dlp
import os

def download_video():
    get_link = link_field.get()
    user_path = path_label.cget("text")
    
    if user_path == "Select Path For Download" or not os.path.isdir(user_path):
        screen.title('请选择有效的下载路径')
        return
    
    ydl_opts = {
        'format': 'bestaudio/best',
        'postprocessors': [{
            'key': 'FFmpegExtractAudio',
            'preferredcodec': 'mp3',
            'preferredquality': '192',
        }],
        'outtmpl': os.path.join(user_path, '%(title)s.%(ext)s'),
        'quiet': False,
    }
    
    try:
        screen.title('Downloading...')
        with yt_dlp.YoutubeDL(ydl_opts) as ydl:
            ydl.download([get_link])
        screen.title('Download Complete!')
    except Exception as e:
        screen.title('下载失败')
        print(f"错误信息: {e}")

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