强制重置插件加载环境可解决prestartup_script.py损坏或manager_core.py初始化失败导致的启动卡死问题，需备份并更新核心模块、清空缓存后重启。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您在本地部署 Core 时遇到插件无法加载、启动卡死、端口绑定失败等异常，问题通常源于依赖冲突、残留进程干扰或配置路径错误。以下是针对性的修复步骤：

一、强制重置插件加载环境

该方法用于清除因 prestartup_script.py 损坏、manager_core.py 初始化失败导致的插件加载中断，适用于启动卡在“Loading custom nodes…”阶段的场景。

1、进入 Core 主程序根目录，定位到 custom_nodes/ComfyUI-Manager 子文件夹。

2、执行命令备份当前 manager_core.py：cp glob/manager_core.py glob/manager_core.py.bak。

3、从官方源拉取最新核心模块：curl -o glob/manager_core.py https://gitcode.com/gh_mirrors/co/ComfyUI-Manager/raw/main/glob/manager_core.py。

4、清空插件缓存目录：rm -rf __pycache__ && rm -f *.pyc。

5、重启 Core 启动脚本，观察控制台是否跳过初始化错误并进入主界面。

二、释放被占用的本地端口

当 Core 启动报错 “Address already in use” 或 “Failed to bind port 8188”，说明目标端口正被其他进程（如旧版 Core 实例、Python 脚本、Node.js 服务）独占，需精准终止对应 PID。

1、在终端中执行端口监听查询命令：lsof -i :8188（macOS/Linux）或 netstat -ano | findstr :8188（Windows）。

2、从输出结果中提取占用该端口的进程 PID（例如显示为 PID 12345）。

3、强制终止该进程：kill -9 12345（Linux/macOS）或 taskkill /f /pid 12345（Windows）。

4、验证端口已释放：curl -I http://127.0.0.1:8188 应返回连接拒绝（Connection refused），而非超时或响应内容。

三、隔离插件依赖冲突

该方案解决因 pip 安装的 gitpython、toml、rich 等依赖版本与 ComfyUI-Manager 内部要求不一致引发的 ImportError 或 AttributeError，避免全局环境污染。

1、进入 Core 根目录，创建独立 Python 虚拟环境：python -m venv .core-env。

2、激活虚拟环境：source .core-env/bin/activate（Linux/macOS）或 .core-env\Scripts\activate.bat（Windows）。

3、仅安装 Manager 所需最小依赖集：pip install gitpython toml rich chardet。

4、修改启动脚本（如 run.bat 或 start.sh），确保调用的是虚拟环境中的 Python：.core-env/bin/python main.py（Linux/macOS）或 .core-env\Scripts\python.exe main.py（Windows）。

四、修正配置路径权限异常

当插件管理器提示 “Permission denied” 或 “Cannot write to manager_files_path”，说明 custom_nodes/ComfyUI-Manager/files 目录存在所有权缺失或只读属性，导致节点下载、缓存写入失败。

1、定位到插件数据目录：custom_nodes/ComfyUI-Manager/files。

2、重置目录所有权（Linux/macOS）：sudo chown -R $USER:$USER custom_nodes/ComfyUI-Manager/files。

3、移除只读属性（Windows）：attrib -R custom_nodes\ComfyUI-Manager\files /S /D。

4、手动创建测试文件验证写入能力：echo "test" > custom_nodes/ComfyUI-Manager/files/.write_test，无报错即成功。

五、禁用冲突的后台代理服务

部分系统级 Agent（如云监控 ces-uniagent、一键重置密码 cloudresetpwdupdateagent）会动态占用 31000–32999 或 49152–65536 端口段，若 Core 配置了相近端口（如 31001、49153），将触发隐性端口冲突且不报明确错误。

1、检查当前活跃的 Agent 服务：ps aux | grep -i "uniagent\|cloudresetpwd"（Linux/macOS）或 sc query | findstr -i "uniagent\|cloudresetpwd"（Windows）。

2、临时停止云监控 Agent：service ces-uniagent stop（Linux）或 net stop "CES UniAgent"（Windows）。

3、停止一键重置密码服务：systemctl stop cloudresetpwdupdateagent（Linux）或 net stop "cloud reset password update agent"（Windows）。

4、启动 Core 并确认插件加载日志中不再出现 “Connection refused by peer” 或 “Timeout waiting for response” 类网络异常。