问题排查 #

┌─────────────────────────────────────────────────────────────┐
│                    问题排查流程                              │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  1. 识别问题                                                │
│     ├── 查看错误信息                                        │
│     ├── 确定问题类型                                        │
│     └── 记录复现步骤                                        │
│                                                             │
│  2. 分析原因                                                │
│     ├── 检查配置                                            │
│     ├── 检查环境                                            │
│     └── 检查资源                                            │
│                                                             │
│  3. 解决问题                                                │
│     ├── 应用解决方案                                        │
│     ├── 验证结果                                            │
│     └── 记录解决方法                                        │
│                                                             │
│  4. 预防复发                                                │
│     ├── 更新配置                                            │
│     ├── 优化环境                                            │
│     └── 建立最佳实践                                        │
│                                                             │
└─────────────────────────────────────────────────────────────┘

CUDA out of memory
────────────────────────

症状：
├── 生成过程中崩溃
├── 错误信息包含 "CUDA out of memory"
└── 程序终止

原因：
├── 显存不足
├── 分辨率过高
├── batch_size 过大
└── 模型过大

解决方案：
1. 使用低显存模式
   python main.py --lowvram

2. 降低分辨率
   ├── 512x512 或更低
   └── 使用放大技术

3. 减少 batch_size
   └── 设置为 1

4. 使用更小的模型
   └── SD 1.5 替代 SDXL

5. 清理显存
   └── 重启 ComfyUI

Model not found / Failed to load model
───────────────────────────────────────

症状：
├── 节点显示红色
├── 无法加载模型
└── 错误信息提示文件未找到

原因：
├── 模型文件不存在
├── 路径错误
├── 文件损坏
└── 格式不兼容

解决方案：
1. 检查模型位置
   ├── 确认文件在正确目录
   ├── checkpoints/ 目录
   └── 检查文件名

2. 验证文件完整性
   ├── 重新下载模型
   ├── 检查文件大小
   └── 验证文件哈希

3. 检查格式兼容性
   ├── SD 1.5 模型用于 SD 1.5
   ├── SDXL 模型用于 SDXL
   └── 使用 safetensors 格式

4. 刷新模型列表
   └── 重启 ComfyUI

Type mismatch / Invalid connection
───────────────────────────────────

症状：
├── 无法连接节点
├── 连接线显示错误颜色
└── 节点执行失败

原因：
├── 数据类型不匹配
├── 缺少必要输入
├── 循环依赖
└── 节点版本不兼容

解决方案：
1. 检查数据类型
   ├── 确认端口类型匹配
   ├── 颜色对应类型
   └── 使用正确节点

2. 检查必要输入
   ├── 所有输入端口已连接
   ├── 参数已设置
   └── 无缺失数据

3. 检查依赖关系
   ├── 无循环连接
   ├── 数据流正确
   └── 节点顺序合理

4. 更新节点
   ├── 检查节点版本
   ├── 更新自定义节点
   └── 重启 ComfyUI

Poor image quality / Artifacts
───────────────────────────────

症状：
├── 图像模糊
├── 变形或失真
├── 颜色异常
└── 细节丢失

原因：
├── 参数设置不当
├── 模型问题
├── 提示词问题
└── VAE 问题

解决方案：
1. 调整采样参数
   ├── 增加步数 (25-35)
   ├── 调整 CFG (7-8)
   ├── 更换采样器
   └── 尝试不同调度器

2. 优化提示词
   ├── 添加质量标签
   ├── 优化负面词
   ├── 调整权重
   └── 简化提示词

3. 检查模型
   ├── 尝试不同模型
   ├── 检查模型完整性
   └── 确认模型适用性

4. 尝试不同 VAE
   ├── 使用内置 VAE
   ├── 加载外部 VAE
   └── 检查 VAE 兼容性

Slow generation / Performance issues
─────────────────────────────────────

症状：
├── 生成时间过长
├── 界面响应慢
└── 系统卡顿

原因：
├── 硬件性能不足
├── 参数设置不当
├── 工作流复杂
└── 系统资源不足

解决方案：
1. 优化参数
   ├── 减少步数
   ├── 降低分辨率
   ├── 使用快速采样器
   └── 减少 batch_size

2. 简化工作流
   ├── 移除不必要节点
   ├── 合并相似操作
   └── 减少中间处理

3. 优化环境
   ├── 启用 xformers
   ├── 更新驱动
   ├── 关闭其他程序
   └── 使用 SSD

4. 硬件升级
   ├── 增加显存
   ├── 更快 GPU
   └── 更多内存

日志查看方法：

1. 控制台输出
   ├── 启动时的日志
   ├── 执行时的日志
   └── 错误堆栈信息

2. 浏览器控制台
   ├── F12 打开开发者工具
   ├── Console 标签
   └── Network 标签

3. 日志文件
   ├── 检查 ComfyUI 目录
   └── 查找日志文件

关键信息：
├── Error 类型
├── 错误位置
├── 相关参数
└── 堆栈跟踪

分步调试方法：

1. 简化工作流
   ├── 从最简单开始
   ├── 逐步添加功能
   └── 定位问题节点

2. 使用 Bypass
   ├── 绕过可疑节点
   ├── 逐个启用测试
   └── 找出问题节点

3. 添加预览
   ├── 在关键位置添加 Preview Image
   ├── 检查中间结果
   └── 确认数据正确

4. 参数测试
   ├── 固定其他参数
   ├── 单独测试一个参数
   └── 记录影响

环境检查清单：

□ Python 版本正确 (3.9-3.11)
□ PyTorch 已正确安装
□ CUDA 可用
□ 显存充足
□ 磁盘空间充足
□ 依赖已安装
□ 自定义节点兼容
□ 模型文件完整

检查步骤：
1. 检查 Python 版本
   python --version

2. 检查依赖
   pip list | grep torch

3. 检查端口占用
   netstat -ano | findstr :8188

4. 检查错误日志
   查看控制台输出

解决方案：
├── 重新安装依赖
├── 更换端口
├── 检查环境变量
└── 重新克隆仓库

检查步骤：
1. 检查 GPU 使用率
   nvidia-smi

2. 检查进度条
   是否在移动

3. 检查队列
   是否有多个任务

解决方案：
├── 等待完成
├── 中断当前任务
├── 清空队列
├── 重启 ComfyUI
└── 检查显存使用

检查步骤：
1. 确认安装位置
   ComfyUI/custom_nodes/

2. 检查文件结构
   __init__.py 是否存在

3. 检查依赖
   requirements.txt

解决方案：
├── 重启 ComfyUI
├── 安装依赖
├── 检查版本兼容性
└── 查看错误日志

常见问题：

手部问题：
├── 添加手部相关负面词
├── 使用手部修复 LoRA
└── 多次生成选择最佳

面部问题：
├── 使用面部修复节点
├── 添加面部负面词
└── 使用 FaceDetailer

背景问题：
├── 优化背景提示词
├── 使用 ControlNet
└── 后期处理修复

维护建议：

1. 定期更新
   ├── 更新 ComfyUI
   ├── 更新自定义节点
   └── 更新模型

2. 清理文件
   ├── 删除不用的模型
   ├── 清理临时文件
   └── 整理输出目录

3. 备份配置
   ├── 保存工作流
   ├── 备份设置
   └── 记录有效配置

4. 监控资源
   ├── 检查显存使用
   ├── 检查磁盘空间
   └── 监控系统状态

预防问题建议：

1. 稳定环境
   ├── 使用虚拟环境
   ├── 固定依赖版本
   └── 避免频繁更新

2. 合理配置
   ├── 根据硬件设置参数
   ├── 不要过度优化
   └── 保持配置简单

3. 测试验证
   ├── 新配置先测试
   ├── 记录有效设置
   └── 逐步添加功能

4. 文档记录
   ├── 记录问题解决方法
   ├── 保存工作流模板
   └── 建立知识库

获取帮助渠道：

1. GitHub Issues
   https://github.com/comfyanonymous/ComfyUI/issues

2. Discord 社区
   ComfyUI 官方 Discord

3. Reddit
   r/StableDiffusion

4. 中文社区
   ├── 知乎
   ├── B站
   └── 各类论坛

提问建议：
├── 描述问题详细
├── 提供错误信息
├── 说明环境配置
└── 附上复现步骤