| 1 | # 故障排查 |
| 2 | |
| 3 | 遇到问题？这里有一些常见问题的解决方案。 |
| 4 | |
| 5 | --- |
| 6 | |
| 7 | ## 安装问题 |
| 8 | |
| 9 | ### 依赖安装失败 |
| 10 | |
| 11 | ```bash |
| 12 | # 清理缓存 |
| 13 | uv cache clean |
| 14 | |
| 15 | # 重新安装 |
| 16 | uv sync |
| 17 | ``` |
| 18 | |
| 19 | --- |
| 20 | |
| 21 | ## 配置问题 |
| 22 | |
| 23 | ### ComfyUI 连接失败 |
| 24 | |
| 25 | **可能原因**: |
| 26 | - ComfyUI 未运行 |
| 27 | - URL 配置错误 |
| 28 | - 防火墙阻止 |
| 29 | |
| 30 | **解决方案**: |
| 31 | 1. 确认 ComfyUI 正在运行 |
| 32 | 2. 检查 URL 配置（默认 `http://127.0.0.1:8188`） |
| 33 | 3. 在浏览器中访问 ComfyUI 地址测试 |
| 34 | 4. 检查防火墙设置 |
| 35 | |
| 36 | ### LLM API 调用失败 |
| 37 | |
| 38 | **可能原因**: |
| 39 | - API Key 错误 |
| 40 | - 网络问题 |
| 41 | - 余额不足 |
| 42 | |
| 43 | **解决方案**: |
| 44 | 1. 检查 API Key 是否正确 |
| 45 | 2. 检查网络连接 |
| 46 | 3. 查看错误提示中的具体原因 |
| 47 | 4. 检查账户余额 |
| 48 | |
| 49 | --- |
| 50 | |
| 51 | ## 生成问题 |
| 52 | |
| 53 | ### 视频生成失败 |
| 54 | |
| 55 | **可能原因**: |
| 56 | - 工作流文件损坏 |
| 57 | - 模型未下载 |
| 58 | - 资源不足 |
| 59 | |
| 60 | **解决方案**: |
| 61 | 1. 检查工作流文件是否存在 |
| 62 | 2. 确认 ComfyUI 已下载所需模型 |
| 63 | 3. 检查磁盘空间和内存 |
| 64 | |
| 65 | ### 图像生成失败 |
| 66 | |
| 67 | **解决方案**: |
| 68 | 1. 检查 ComfyUI 是否正常运行 |
| 69 | 2. 尝试在 ComfyUI 中手动测试工作流 |
| 70 | 3. 检查工作流配置 |
| 71 | |
| 72 | ### TTS 生成失败 |
| 73 | |
| 74 | **解决方案**: |
| 75 | 1. 检查 TTS 工作流是否正确 |
| 76 | 2. 如使用声音克隆，检查参考音频格式 |
| 77 | 3. 查看错误日志 |
| 78 | |
| 79 | --- |
| 80 | |
| 81 | ## 性能问题 |
| 82 | |
| 83 | ### 生成速度慢 |
| 84 | |
| 85 | **优化建议**: |
| 86 | 1. 使用本地 ComfyUI（比云端快） |
| 87 | 2. 减少分镜数量 |
| 88 | 3. 使用更快的 LLM（如 Qianwen） |
| 89 | 4. 检查网络连接 |
| 90 | |
| 91 | --- |
| 92 | |
| 93 | ## 其他问题 |
| 94 | |
| 95 | 仍有问题？ |
| 96 | |
| 97 | 1. 查看项目 [GitHub Issues](https://github.com/AIDC-AI/Pixelle-Video/issues) |
| 98 | 2. 提交新的 Issue 描述你的问题 |
| 99 | 3. 包含错误日志和配置信息以便快速定位 |
| 100 | |
| 101 | --- |
| 102 | |
| 103 | ## 日志查看 |
| 104 | |
| 105 | 日志文件位于项目根目录： |
| 106 | - `api_server.log` - API 服务日志 |
| 107 | - `test_output.log` - 测试日志 |
| 108 | |
| 109 |