首頁

目前文章總數:255 篇

  

最後更新:2026年 10月 24日

0017. 排除 ComfyUI Docker 重啟後 NumPy 自動升級,導致 Seed-VC/Numba 無法載入的問題 - 踩坑紀錄

日期:2026年 10月 24日

標籤: Linux Ubuntu Docker Docker-Compose ComfyUI WSL 2.2 Seed-VC ComfyUI-Timbre-Transfer Voice Conversion Singing Voice Conversion Timbre Transfer AI Music

摘要:生成式AI


應用所需:1. 已安裝並可正常執行 ComfyUI - 並且匯入 Seed-VC 相關工作流時
解決問題:1. 執行 Seed-VC 工作流時,會出現 ImportError: Numba needs NumPy 2.4 or less. Got NumPy 2.5. 相關錯誤
相關參考:0016. 讓 AI 歌曲換成想要的聲音!Seed-VC × ComfyUI-Timbre-Transfer 零訓練歌聲替換實戰(此為個案,且非每個環境都有相同問題,因此與上篇文章分開說明)
本篇分為 3 大部分。
第一部分:問題描述
第二部分:解決問題 - 建立啟動腳本
第三部分:驗證成果






第一部分:問題描述

Step 1:問題描述

在上篇文章的 第二部分 - Step8. 手動安裝擴充節點後
重新啟動 Docker 時,運行該工作流會出現以下錯誤:

ImportError: Numba needs NumPy 2.4 or less. Got NumPy 2.5.




Step 2:問題原因

這是因為 Docker 映像在啟動時會執行初始化程序,會重新安裝或更新 Python 套件,導致此問題出現:

numpy 2.4.6 → numpy 2.5.x


並且出現版本有小於的訊息 numpy < 2.5
如果讀者也有出現相同的狀況,讀者可繼續參考 本篇的第二部分解法,來解決此問題



第二部分:解決問題 - 建立啟動腳本

Step 1:確認目前自己套件版本

先檢查自己的 ComfyUI 使用的 NumPy、Numba 版本與相依性
開啟 PowerShell 輸入以下:

docker exec comfyui-nvidia /comfy/mnt/venv/bin/python -m pip show numpy numba
docker exec comfyui-nvidia /comfy/mnt/venv/bin/python -m pip check



預期會出現

docker exec comfyui-nvidia /comfy/mnt/venv/bin/python -m pip show numpy numba
==> 2.5.3
docker exec comfyui-nvidia /comfy/mnt/venv/bin/python -m pip check
==> NOT_FOUND


2.5.3 是當前的版本號,而 NOT_FOUND 代表沒有既有啟動腳本,我們可以建立新的 user_script.bash ,來做 啟動腳本


Step 2:建立啟動修復腳本

因為確定了 NOT_FOUND 沒有啟動腳本,那麼我們可以選擇新增的方式 (如果已有存在則是將下列腳本編輯添加)

#!/bin/bash
set -e
/comfy/mnt/venv/bin/python -m pip install --disable-pip-version-check --no-deps "numpy==2.4.6"


然後再執行 Docker 啟動指令,將 NumPy 恢復成原來的 2.5.3

docker exec --user ubuntu comfyui-nvidia /comfy/mnt/venv/bin/python -m pip install --no-deps --force-reinstall "numpy==2.5.3"


最後重新啟動 (※comfyui-nvidia 是我的 ComfyUI 的容器名稱)

docker restart comfyui-nvidia


如果是用 WSL 的 Docker Container ,可以找到對應的腳本存放位置,提供參考:




第三部分:驗證成果

Step 1:驗證 - 可恢復正常

最後再次執行 Seed-VC 工作流時,對應該篇第三部分 Step 10. 後續內容可正常操作:「0016. 讓 AI 歌曲換成想要的聲音!Seed-VC × ComfyUI-Timbre-Transfer 零訓練歌聲替換實戰」