报错
032
依赖缺失与自定义节点安装失败
有来源可查
pip install 装到了系统 Python 而不是 ComfyUI 内置 Python(依赖显示已装但节点仍报缺包)
报错原文(原样)
File "/app/custom_nodes/ComfyUI_FizzNodes/ScheduledNodes.py", line 4, in <module> import numexpr ModuleNotFoundError: No module named 'numexpr' Cannot import /app/custom_nodes/ComfyUI_FizzNodes module for custom nodes: No module named 'numexpr' File "/app/custom_nodes/ComfyUI-AudioScheduler/nodes.py", line 5, in <module> import pandas as pd ModuleNotFoundError: No module named 'pandas'
检索关键词
No module named 'numexpr'、No module named 'pandas'、Cannot import /app/custom_nodes、python_embeded、pip install -r requirements.txt、依赖已装但仍报错、装错 Python
先看这一句
节点目录明明在 custom_nodes 里,启动日志却逐个报 Cannot import ... No module named 'xxx'(例如 numexpr、pandas);也有人在整合包/Desktop 里按 README 的相对路径命令装依赖,却提示找不到文件或命令无法识别,装完重启仍报同一个缺包错误。
适用版本 全版本通用(是环境隔离问题,不是 bug)
·
核实日期 2026-09-26
·
状态 已核实
适用环境:Windows 便携版、秋叶/绘世整合包、ComfyUI Desktop、Linux + 云 GPU、Docker/服务器
现象与触发场景
常见触发场景:
- 在便携版/整合包里直接敲 pip install xxx,落到系统 Python 或另一个 venv
- 照抄节点 README 里的相对路径命令 ..\..\..\python_embeded\python.exe,但当前所在目录层级不对
- ComfyUI Desktop 使用自己的 Python 环境,用户在系统终端里安装依赖完全没生效
- Docker/云端实例重启后容器内环境重置,custom_nodes 从挂载卷加载而依赖没跟着恢复
根因
- ComfyUI 用的是它自己的解释器(便携版为 python_embeded\python.exe,自建安装为对应 venv,Desktop 为应用数据目录内的环境),系统 PATH 里的 python/pip 是另一个环境
- README 里的相对路径依赖当前工作目录,层级错一层就找不到文件
- custom_nodes 与 Python 环境分离时(Docker 挂载卷、只备份了 custom_nodes、换新实例),节点在而依赖不在
解决步骤
已按「最可能有效」排序。请从上往下做,每做完一步用「验证」确认,不要一次改五处。
- 先确定 ComfyUI 实际使用的解释器路径看启动日志里的 ** Python executable: 一行,那就是唯一正确的解释器。日志里同时会打印 ComfyUI Path 与 User directory,可一并核对。之后所有依赖都装到它下面,别用系统的 pip。
- 用绝对路径 + -m pip 安装用绝对路径调用该解释器的 -m pip,能避免相对路径层级错误与 PATH 混淆。先打印它的 site-packages,再执行安装,可一眼看出装到哪去了。C:\ComfyUI\python_embeded\python.exe -c "import site; print(site.getsitepackages())"C:\ComfyUI\python_embeded\python.exe -m pip install -r C:\ComfyUI\ComfyUI\custom_nodes\ComfyUI-OmniGen\requirements.txt
- 节点在、依赖不在时,用 Manager 批量恢复依赖官方 cm-cli 文档给出的正是这个场景:custom_nodes 下有节点但依赖没装(新开的云实例、只还原了 custom_nodes 目录等),可用 restore-dependencies 命令统一重装依赖并重跑安装脚本;对单个节点也可用 fix。.\python_embeded\python.exe ComfyUI\custom_nodes\ComfyUI-Manager\cm-cli.py restore-dependencies.\python_embeded\python.exe ComfyUI\custom_nodes\ComfyUI-Manager\cm-cli.py fix <节点名>
- 验证模块确实装在该解释器里用该解释器直接导入模块并打印文件路径,确认落在 ComfyUI 自带环境的 site-packages 中,而不是别处。C:\ComfyUI\python_embeded\python.exe -c "import cv2; print(cv2.__file__)"
验证是否修好
在 ComfyUI 解释器下能成功 import 该模块并打印出位于 ComfyUI 自带环境内的路径;重启 ComfyUI 后日志中相应节点不再出现 Cannot import ... No module named。
补充说明
error_text 给出的两条 Traceback 与 Cannot import 行取自 ComfyUI 官方 issue #6035 的真实日志(Docker 挂载 custom_nodes 场景,缺少 numexpr 与 pandas),它示范了“节点目录在、依赖不在”的形态;README 相对路径命令无法识别一事来自节点仓库 issue #39(用户执行 README 里的 ..\..\..\python_embeded\python.exe -m pip install -r requirements.txt 报命令不可识别)。本条标题与步骤同时覆盖这两种表现。
来源
按可信度排列:官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。
链接以纯文本给出(本站不做站外跳转),需要核对时请自行复制到浏览器打开。
- [86] (节点仓库 issue) problem to install the Install the required Python packages · Issue #3 https://github.com/1038lab/ComfyUI-OmniGen/issues/39
- [87] (官方 issue) Custom node dependencies not installed when imported on startup · Issu https://github.com/Comfy-Org/ComfyUI/issues/6035
- [88] (官方文档) cm-cli: ComfyUI-Manager CLI(restore-dependencies / fix 命令) https://raw.githubusercontent.com/Comfy-Org/ComfyUI-Manager/main/docs/en/cm-cli.md
这条报错要用到的东西
按本条报错所属的类别(依赖缺失与自定义节点安装失败)列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」,而是这一类问题里最常要动到的东西;具体怎么做,以上面的解决步骤为准。
常用节点速查包常用节点参数小抄 / 常见连法示意图
待挂载
节点库按用途找节点仓库,附适配模型与下载量
板块
同一类别的其他条目
【023】报错 No module named 'insightface'(IPAdapter 人脸加载器 / ReActor 换脸节点不可用)
有来源
【024】一个节点包报错导致 / 或看似导致所有自定义节点加载中断(Cannot import ... custom_nodes)
有来源
【025】报错 No module named 'cv2'(controlnet_aux / WanVideoWrapper 等节点导入失败)
有来源
【026】报错 ImportError: DLL load failed while importing onnxruntime_pybind11_state(缺 Visual C++ 运行库 / onnxruntime 版本不匹配)
有来源
【027】报错 ImportError: cannot import name 'cached_download' from 'huggingface_hub'(diffusers 与新版 huggingface_hub 不兼容)
有来源
这个解法对你有效吗
记录只存在你自己的浏览器里,不需要注册账号。
知仓学习社