Azure Function中videohash嵌套依赖触发问题排查

问题原因 #

• Azure Function的Python运行环境中，通过pip安装的yt-dlp可执行文件位于虚拟环境的私有目录（Linux环境为bin，Windows环境为Scripts），但该目录默认未被加入到Function进程的PATH环境变量中。
• videohash的downloader.py中使用which("yt-dlp")命令查找可执行文件，该命令仅搜索系统PATH包含的路径，因此无法定位到虚拟环境内的yt-dlp可执行文件。

解决方案 #

方案1：手动添加虚拟环境路径到PATH #

在你的Function入口文件（如__init__.py）开头添加以下代码，将虚拟环境的可执行目录加入系统PATH，确保which能找到yt-dlp：

import os
import sys
from pathlib import Path

# Linux环境用"bin"，Windows环境替换为"Scripts"
venv_exec_dir = Path(sys.executable).parent / "bin"
os.environ["PATH"] = str(venv_exec_dir) + os.pathsep + os.environ["PATH"]

方案2：绕过which，直接指定yt-dlp路径 #

如果允许修改videohash源码（或通过猴子补丁临时修改），可以将downloader.py中的self.yt_dlp_path = str(which("yt-dlp"))替换为直接指向虚拟环境中的yt-dlp路径：

import sys
from pathlib import Path

# Linux环境用"bin/yt-dlp"，Windows环境替换为"Scripts/yt-dlp.exe"
self.yt_dlp_path = str(Path(sys.executable).parent / "bin" / "yt-dlp")

方案3：改用yt-dlp的Python API #

如果有长期维护需求，可以修改videohash的下载逻辑，直接调用yt-dlp的Python模块而非外部命令，彻底避免路径依赖问题。例如使用yt_dlp.YoutubeDL类实现视频下载，替代调用外部进程的方式。

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