Pytube路径未找到与MoviePy偶发文件缺失报错问题咨询

一、「Pytube Path not found」报错的排查与修复 #

咱们先搞定第一个问题，这个报错通常和路径的存在性、权限或者Pytube本身的处理逻辑有关，具体原因和解决办法如下：

可能的原因 #

• 目标路径不存在或无权限：如果Pytube下载时指定的路径（不管是默认还是自定义）不存在，或者你的Python进程没有读写该路径的权限，就会触发这个错误。
• 自定义路径配置错误：要是你手动指定了下载路径，可能存在拼写错误、路径包含特殊字符（比如空格、非ASCII字符），或者路径里的某个父文件夹还没创建。
• Pytube版本bug：旧版本的Pytube在路径处理上有兼容性问题，比如对macOS或Windows的路径格式支持不完善。

解决方案 #

1. 确保目标路径存在：在下载前先创建路径，用os.makedirs()配合exist_ok=True可以避免重复创建报错，示例代码：

import os
from pytube import YouTube

download_path = "/Users/xxx/your_download_folder"
# 创建路径，不存在则创建，存在则跳过
os.makedirs(download_path, exist_ok=True)

# 下载视频时指定路径
yt = YouTube("your_video_url")
stream = yt.streams.get_audio_only()
stream.download(output_path=download_path)

2. 检查路径权限：macOS/Linux可以用chmod 755 /your/path调整权限，Windows则右键文件夹→属性→安全，确保当前用户有读写权限。
3. 更新Pytube到最新版：旧版本的路径bug很多，运行pip install --upgrade pytube就能解决大部分兼容性问题。

二、MoviePy偶尔「文件找不到」的问题分析 #

看了你提供的代码，这个报错大概率是文件名拼接或者下载时机的问题，咱们拆解一下：

核心原因 #

1. 标题含非法字符导致文件名不匹配：YouTube视频标题可能包含)、/、:这类操作系统禁止的字符，Pytube下载时会自动替换这些字符，但你代码里直接用self.title拼接文件名，导致你生成的MP4路径和实际下载的文件名不一致，MoviePy自然找不到文件。
2. 路径拼接格式错误：如果self.MP4_path末尾没有斜杠，拼接后会变成/Users/xxx/foldertitle.mp4（缺少文件夹和文件名的分隔符），实际文件却在/Users/xxx/folder/title.mp4。
3. 下载未完成就执行转换：如果网络不稳定，Pytube还没把文件完全写入磁盘，你的convertSong就开始读取，此时文件要么不存在要么不完整。

修复后的代码及说明 #

我给你调整了代码，解决了上述问题：

import os
import re
from moviepy.editor import VideoFileClip

def sanitize_filename(filename):
    # 过滤掉操作系统不允许的文件名字符
    return re.sub(r'[\\/*?:"<>|]', '', filename)

def convertSong(self):
    try:
        # 1. 先处理标题中的非法字符，确保文件名合法
        sanitized_title = sanitize_filename(self.title)
        # 2. 用os.path.join自动处理路径分隔符，避免拼接错误
        MP4 = os.path.join(self.MP4_path, f"{sanitized_title}.mp4")
        MP3 = os.path.splitext(MP4)[0] + ".mp3"
        
        # 3. 提前检查文件是否存在，避免后续报错
        if not os.path.exists(MP4):
            print(f"Error: 文件 {MP4} 不存在，请确认视频是否下载完成")
            return
        
        videoclip = VideoFileClip(MP4)
        audioclip = videoclip.audio
        audioclip.write_audiofile(MP3)
        audioclip.close()
        videoclip.close()
    except Exception as e:
        print("Exception!!")
        print(e)

另外还要注意：

• 确保调用convertSong的时机是在Pytube下载完成之后（stream.download()是阻塞式的，下载完才会返回，所以只要顺序正确就没问题）。
• 如果还是偶尔出现问题，可以在下载完成后加个短暂的延迟（比如time.sleep(1)），确保文件完全写入磁盘。

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