Mac系统下RVC-Project无法启动Web界面问题求助

问题描述 #

执行sh ./run.sh时出现以下异常：

• 未启动Web服务器，持续进入模型下载流程
• 已成功下载f0G40k.pth，但脚本反复提示该文件不存在
• ./run.sh -help/--help参数无效，脚本仍执行模型下载操作

运行日志示例：

❯ sh ./run.sh
 Activate venv...
 working dir is /Users/inok_Roman/Retrieval-based-Voice-Conversion-WebUI
 downloading requirement aria2 check.
 aria2 command found
 dir check start.
 dir ./assets/pretrained checked
 dir ./assets/pretrained_v2 checked
 dir ./assets/uvr5_weights checked
 dir ./assets/uvr5_weights/onnx_dereverb_By_FoxJoy checked
 dir check finished.
 required files check start.
 checking D32k.pth
 D32k.pth in ./assets/pretrained checked.
 checking D40k.pth
 D40k.pth in ./assets/pretrained checked.
 checking D48k.pth
 D48k.pth in ./assets/pretrained checked.
 checking G32k.pth
 G32k.pth in ./assets/pretrained checked.
 checking G40k.pth
 G40k.pth in ./assets/pretrained checked.
 checking G48k.pth
 G48k.pth in ./assets/pretrained checked.
 checking f0D40k.pth
 f0D40k.pth in ./assets/pretrained_v2 checked.
 checking f0G40k.pth
 failed. starting download from huggingface.
 [#505f88 69MiB/69MiB(99%) CN:1 DL:11MiB]
 Download results:
 gid |stat|avg speed |path/URI
 ======+====+==========+============================================
 505f88|OK | 10MiB/s|./assets/pretrained_v2/f0G40k.pth

 Symbols used:
 (OK): Download complete.
 download successful.

解决步骤 #

1. 验证模型文件与权限 #

• 检查./assets/pretrained_v2/f0G40k.pth文件大小，正常约为69MiB，若大小不符则删除后重新下载
• 赋予文件读取权限：

  chmod +r ./assets/pretrained_v2/f0G40k.pth
  

2. 修正脚本的文件检查逻辑 #

打开run.sh，定位到f0G40k.pth的检查代码段，将相对路径改为绝对路径以避免解析错误：

# 替换原检查代码
TARGET_FILE="/Users/inok_Roman/Retrieval-based-Voice-Conversion-WebUI/assets/pretrained_v2/f0G40k.pth"
if [ -f "$TARGET_FILE" ]; then
    echo "f0G40k.pth in ./assets/pretrained_v2 checked."
else
    # 保留原下载逻辑
fi

3. 跳过模型检查直接启动服务 #

确认所有预训练模型已齐全后，可注释掉脚本中的模型检查代码，直接执行Web服务启动命令（通常为python infer-web.py或类似语句）。

4. 修复参数处理逻辑 #

在run.sh开头添加参数判断，让-help/--help生效：

if [[ "$1" == "-help" || "$1" == "--help" ]]; then
    echo "RVC WebUI 启动脚本用法："
    echo "  sh run.sh          启动WebUI，自动检查并下载缺失模型"
    echo "  sh run.sh -skip    跳过模型检查，直接启动WebUI"
    exit 0
fi

额外排查点 #

• 确认虚拟环境激活正常，Activate venv...步骤无报错
• 验证aria2可用：执行aria2c -v查看版本信息
• 若问题持续，尝试重新克隆项目仓库并重新配置环境

内容的提问来源于stack exchange，提问作者Dimas del Pablo