如何避免GeneFace Plus Plus报错

GeneFace++（GeneFace Plus Plus）在训练和推理时容易因为环境、数据格式、路径、版本不匹配而报错。下面从最常见报错原因 → 对应解决办法系统说明，基本能覆盖 90% 的情况。

一、环境相关（最重要）

1. Python / PyTorch 版本不匹配

GeneFace++ 对版本较敏感。
✅ 推荐环境：

• Python 3.8 / 3.9
• PyTorch 1.12–1.13（不要直接用 2.x）
• CUDA 11.3 / 11.6

❌ 常见错误：

• torch 2.x + 老代码
• CUDA 版本不匹配

✅ 解决：

conda create -n geneface python=3.9
conda activate geneface
pip install torch==1.13.1+cu116 torchvision==0.14.1+cu116 -f https://download.pytorch.org/whl/torch_stable.html

2. 缺少依赖或版本冲突

常见报错：

• No module named 'xxx'
• version conflict

✅ 建议：

pip install -r requirements.txt

若失败，逐个安装并固定版本。

二、数据准备相关（高频报错）

3. 音频 / 视频 / 图像格式不对

GeneFace++ 对格式非常严格。
✅ 要求：

• 音频：16k / 22.05k WAV（单声道）
• 视频：25 / 30 fps
• 人脸图像：清晰正脸

❌ 错误示例：

• mp3 直接喂
• 视频有黑边
• 多人脸

✅ 工具预处理：

ffmpeg -i input.mp4 -vn -acodec pcm_s16le -ar 22050 audio.wav

4. landmarks / 3DMM 提取失败

报错示例：

• NoneType has no attribute
• landmark not found

✅ 解决：

• 使用官方 preprocess 脚本
• 人脸必须清晰、无遮挡
• 不要裁太狠

三、路径与配置相关

5. 路径写错（最常见）

错误：

• 相对路径
• Windows 反斜杠
• 中文路径

✅ 建议：

• 全部用绝对路径
• Linux 风格 /
• 无中文、无空格

data:
root: /data/geneface/speaker1

6. config 文件字段缺失

报错：

• KeyError: 'xxx'

✅ 解决：

• 不要手改 config
• 用官方 example 复制后改路径

四、训练 / 推理阶段

7. 显存不足（OOM）

报错：

• CUDA out of memory

✅ 解决：

• 减小 batch_size
• 降低 img_size
• 用单卡

8. 模型权重缺失

报错：

• Missing key(s) in state_dict

✅ 解决：

• 确认下载完整
• 不要混用不同版本权重

五、通用排错流程（强烈建议）

1. 先用 官方 demo 数据 跑通
2. 再替换自己的数据
3. 每一步都看 log
4. 不要跳预处理

六、如果你愿意，我可以更精准帮你

你可以直接贴：

• 报错信息（完整）
• 使用的命令
• 系统 / CUDA / PyTorch 版本

我可以逐行帮你定位并给出修改方案。