解决 ComfyUI-DepthAnythingV3 插件 PRESTARTUP FAILED 报错的完整教程

PozzettiAndrea/ComfyUI-DepthAnythingV3：对DepthAnything V3模型的ComfyUI支持

玩转 ComfyUI 高阶运维修复专栏 | 免费

【ComfyUI/SD环境管理指南（一）】：如何避免插件安装导致的环境崩溃与快速修复

【ComfyUI/SD环境管理指南（二）】：如何避免插件安装导致的环境崩溃与“外科手术式”修复

消除 ComfyUI-DepthAnythingV3 插件「e3nn 依赖缺失」提示的实操指南

问题背景

安装 ComfyUI-DepthAnythingV3 插件（路径：H:\PythonProjects3\Win_ComfyUI\custom_nodes\ComfyUI-DepthAnythingV3）后，即使安装了 requirements.txt ，仍可能会有此报错，启动 ComfyUI 出现以下两种核心报错：

Failed to execute startup-script: H:\PythonProjects3\Win_ComfyUI\custom_nodes\ComfyUI-DepthAnythingV3\prestartup_script.py / No module named 'comfy_env'
Prestartup times for custom nodes:
   0.0 seconds (PRESTARTUP FAILED): H:\PythonProjects3\Win_ComfyUI\custom_nodes\ComfyUI-DepthAnythingV3

或：

Failed to execute startup-script: H:\PythonProjects3\Win_ComfyUI\custom_nodes\ComfyUI-DepthAnythingV3\prestartup_script.py / No module named 'comfy_3d_viewers'
Prestartup times for custom nodes:
   0.0 seconds (PRESTARTUP FAILED): H:\PythonProjects3\Win_ComfyUI\custom_nodes\ComfyUI-DepthAnythingV3

该报错可能为致命错误，直接导致 DepthAnythingV3 插件无法加载，核心原因是插件预启动脚本依赖 comfy_env 和 comfy_3d_viewers 模块，但该模块未安装。

---

---

---

核心原因分析

1. comfy_env 和 comfy_3d_viewers 是 ComfyUI 生态的环境管理和功能实现的专用模块，DepthAnythingV3 插件的预启动脚本（prestartup_script.py）会调用该模块做环境隔离检查；
2. 未安装 comfy_env 和 comfy_3d_viewers 时，预启动脚本执行失败，插件被标记为 PRESTARTUP FAILED，无法正常加载；
3. 该模块非 Python 官方库，需手动安装，且需保证安装在 ComfyUI 虚拟环境中。

---

---

---

完整修复步骤（Windows PowerShell 环境）

前置条件

• 已激活 ComfyUI 虚拟环境（路径：H:\PythonProjects3\Win_ComfyUI）；
• 已克隆 ComfyUI-DepthAnythingV3 插件到 custom_nodes 目录；
• 已安装 260 + 其他 ComfyUI 插件，需保证新安装依赖不冲突现有环境。

步骤 1：安装 comfy_env 核心模块

# 安装 comfy_env 模块，优先用 --no-deps 避免依赖冲突
pip install comfy-env --no-deps

执行结果：

• 成功安装 comfy-env==0.2.25（适配当前 ComfyUI 环境的稳定版本）；
• 因 --no-deps 限制，仅安装模块本体，不修改现有依赖（保护 260 + 插件的环境）。

---

---

步骤 2：安装插件依赖的 comfy_3d_viewers 模块

DepthAnythingV3 插件除 comfy_env 外，还依赖 comfy_3d_viewers 实现 3D 视图功能，需补充安装：

# 安装 comfy_3d_viewers 模块，同样用 --no-deps 保稳定
pip install comfy-3d-viewers --no-deps

执行结果：

• 成功安装 comfy-3d-viewers==0.2.36；
• 模块被安装到 ComfyUI 虚拟环境路径：H:\PythonProjects3\Win_ComfyUI\.venv\Lib\site-packages。

---

---

步骤 3：验证模块安装有效性

# 验证 comfy_env 能否正常导入
python -c "import comfy_env; print('comfy_env 导入成功')"

# 验证 comfy_3d_viewers 能否正常导入
python -c "import comfy_3d_viewers; print('comfy_3d_viewers 导入成功')"

预期结果：

两行命令均输出 “导入成功”，无 ModuleNotFoundError 报错；若首次导入报错，可执行 pip show comfy-3d-viewers 触发缓存刷新后重试。

---

---

步骤 4：重启 ComfyUI 验证插件加载

# 进入 ComfyUI 根目录启动
cd H:\PythonProjects3\Win_ComfyUI
python main.py

---

---

---

验证修复效果

启动日志中彻底消失以下报错：

Failed to execute startup-script: ... / No module named 'comfy_env'
0.0 seconds (PRESTARTUP FAILED): ComfyUI-DepthAnythingV3

取而代之的是正常加载的日志：

[PRE] ComfyUI-Manager
[comfy-env] ComfyUI-DepthAnythingV3: no isolation envs
[comfy-env] prestartup complete
Prestartup times for custom nodes:
   0.7 seconds: H:\PythonProjects3\Win_ComfyUI\custom_nodes\ComfyUI-DepthAnythingV3

• no isolation envs 是正常提示，代表插件无需专属隔离环境，使用主虚拟环境即可；
• 插件预加载耗时 0.7 秒（正常加载模型 / 资源），无任何失败标记。

日志核心信息解读

关键日志	说明
[comfy-env] ComfyUI-DepthAnythingV3: no isolation envs + prestartup complete	DepthAnythingV3 节点的预启动脚本执行成功，无任何报错，PRESTARTUP FAILED 彻底消失
1.3 seconds: ComfyUI-DepthAnythingV3	节点正常预启动（耗时 1.3 秒是加载模型 / 资源的正常现象）
SAM3DBody、rgthree-comfy、Easy-Use 节点均显示 0.0 seconds	所有其他节点也都正常加载

小结

1. DepthAnythingV3 节点：安装 comfy-env + comfy-3d-viewers 补全小众依赖，解决了预启动脚本的模块缺失问题；
2. 基础环境：验证了 requirements.txt 所有依赖完整，PyTorch 2.7.1+cu126 环境正常。

现在我们的 ComfyUI 已无任何节点加载报错，所有核心功能（图像超分、深度估计、SAM3D 等）都能正常使用，无需再进行任何环境修复操作。

[comfy-env] ComfyUI-DepthAnythingV3: no isolation envs 什么意思？

从日志中看到的 [comfy-env] ComfyUI-DepthAnythingV3: no isolation envs 是 comfy-env 模块输出的正常提示，完全不是报错，反而说明 DepthAnythingV3 节点的环境检查已通过，我给你拆解清楚：

核心含义

• comfy-env：是你安装的 ComfyUI 环境管理模块，作用是为不同节点创建「隔离环境」（避免节点间依赖冲突）；
• no isolation envs：直译是「无隔离环境」，实际意思是：✅ ComfyUI-DepthAnythingV3 节点不需要专属的隔离环境，直接使用当前 ComfyUI 主虚拟环境即可，无需额外创建 / 配置环境。

为什么会出现这个提示？

comfy-env 在执行节点预启动脚本时，会先检查该节点是否配置了「隔离环境规则」：

1. 如果节点有专属依赖（容易和主环境冲突），comfy-env 会自动创建隔离环境；
2. 如果节点无特殊依赖（如 DepthAnythingV3 仅依赖 comfy_3d_viewers，无冲突风险），就会输出这个提示，直接使用主环境。

关键结论

这个提示是 comfy-env 的正常日志，代表：

• DepthAnythingV3 节点的环境检查通过；
• 节点将使用你当前的 ComfyUI 虚拟环境运行；
• 无任何环境冲突 / 配置问题，你可以放心使用该节点的深度估计功能。

总结

[comfy-env] ComfyUI-DepthAnythingV3: no isolation envs 是「环境检查通过 + 无需隔离环境」的友好提示，不是报错，反而印证了 DepthAnythingV3 节点已完全适配我们的 ComfyUI 环境，现在该节点可以正常使用了。

---

---

---

关键注意事项

1. --no-deps 参数的灵活使用：
   • 本次修复中，comfy_env 和 comfy_3d_viewers 均为专用模块，无复杂依赖，用 --no-deps 安装可避免覆盖现有插件的依赖版本；
   • 若安装后仍提示依赖缺失，可放弃 --no-deps 重新安装（pip install comfy-env），但需注意：仅在专用模块检测失败时使用，优先保现有环境稳定。
2. 缓存延迟问题：
   • 安装模块后首次导入可能报错，是 PowerShell 缓存未刷新导致，执行 pip show [模块名] 或重启终端即可解决；
3. 插件兼容性：
   • 修复后插件核心功能（深度估计）完全可用，comfy_env 仅用于环境检查，不影响业务逻辑。

---

---

---

总结

1. 报错根源：DepthAnythingV3 插件预启动脚本依赖 comfy_env 和 comfy_3d_viewers 模块，未安装导致脚本执行失败；
2. 修复核心：安装缺失的 comfy_env + comfy_3d_viewers 模块，用 --no-deps 保护现有 260 + 插件的依赖环境；
3. 最终效果：插件成功加载，无 PRESTARTUP FAILED 报错，核心功能正常使用。