Llama-Factory 训练进度条卡住排查与优化指南

解决方案很简单：开启多进程预处理并启用缓存。

preprocessing_num_workers: 8
dataset_num_proc: 8
cache_dir: "./cache"

这样下次再训练时就能直接加载缓存，速度提升十倍不止。顺便提醒一句，永远不要在 NFS 或 SMB 共享盘上做原始数据读取，网络延迟会让 DataLoader 变成'龟速加载器'。

另一个高频杀手是显存不足。

尤其是当你试图在一张 24GB 显卡上微调 Llama-3-8B 这类大模型时，即使用了 LoRA，激活内存（activation memory）仍可能爆掉。特别是序列长度拉到 4096 以上，batch size 又设成 8 的时候，OOM 几乎不可避免。

这里有个实用技巧：自己写个简单的内存监控回调。

import torch
from transformers import TrainerCallback

class MemoryMonitorCallback(TrainerCallback):
    def on_step_begin(self, args, state, control, model=None, **kwargs):
        if state.global_step % 10 == 0:
            allocated = torch.cuda.memory_allocated() / 1024**3
            print(f"Step {state.global_step} | GPU Memory: {allocated:.2f} GB")

注册到训练器中，就能实时观察显存增长趋势。一般来说，建议预留至少 20% 的显存余量，否则梯度累积或 optimizer 状态可能会触发意外崩溃。

对于超大模型，梯度检查点（Gradient Checkpointing）几乎是必选项。它通过牺牲约 20%-30% 的训练时间，换来显存占用的大幅下降。

gradient_checkpointing: true

原理是不保存所有中间激活值，而是在反向传播时重新计算部分 forward 结果。注意，并非所有模型结构都支持，某些自定义层可能导致 recompute 失败。

如果你的硬件实在有限，那就得考虑 QLoRA 了。

这是一种将量化和 LoRA 结合的技术，能在 4-bit 权重下加载大模型，仅需微调少量适配器参数。实测表明，在单张 RTX 3090 上也能跑通 Llama-3-8B 的微调任务。

配置也很简单：

quantization_bit: 4
use_lora: true
lora_target: "q_proj,v_proj,k_proj,o_proj"
lora_rank: 64
lora_alpha: 16

关键是选择正确的 target modules，不同模型的注意力投影层命名略有差异，可以参考官方文档或打印模型结构确认。

说到这里，还有一个容易被忽视的层面：前端通信本身也可能出问题。

Gradio 使用 WebSocket 实现前后端异步通信，但如果版本太旧，存在连接断开后无法自动重连的 bug。有些用户反映训练跑了几个小时，突然进度条冻结，但实际上后台仍在训练——就是因为前端丢了心跳包。

升级 Gradio 往往能解决这类'幽灵卡顿'：

pip install --upgrade gradio

同时建议使用 Chrome 或 Firefox 浏览器，避免 Edge 或某些国产浏览器内置插件干扰 WebSocket 连接。关闭广告拦截工具也是一个好习惯。

实际案例复盘

举个实际例子。某医疗 AI 团队想基于 Llama-3-8b 微调一个专科问诊助手，导入了 10 万条医患对话数据。启动训练后进度条卡在 0%，持续十分钟无变化。他们差点准备重启，幸好先看了眼 nvidia-smi —— GPU 利用率 98%，显然训练没停。

接着查日志，发现卡在 "Preparing DataLoader..." 阶段。进一步分析数据发现，原始文本平均长度超过 8192 tokens，而且没有做任何切分。分词器处理这种长文本时内存占用飙升，导致预处理耗时极长。

最终解决方案包括：

• 添加清洗脚本，按段落拆分长文档；
• 设置 max_seq_length: 2048 并开启 truncation=True；
• 启用多进程处理：num_proc=8；
• 使用内存映射避免重复加载。

调整后，数据准备时间从 15 分钟缩短到 45 秒，训练顺利推进。

这个案例告诉我们：数据质量比数量更重要。盲目堆样本只会拖慢整个 pipeline。合理的做法是先用 100 条小样本跑通全流程，验证配置无误后再放大规模。

系统化排查思路

回到最初的问题：如何系统应对'进度条卡住'？

我们可以建立分层排查逻辑：

第一层：确认是否真卡

• 查 nvidia-smi 看 GPU 利用率
• 查 htop 看 CPU 和内存占用
• 观察是否有 OOM 错误

第二层：定位阻塞环节

• 检查日志最后输出位置
• 区分是模型加载、数据读取还是训练中止
• 用最小配置复现问题（如 batch_size=1）

第三层：针对性优化

• 数据瓶颈 → 开启缓存 + 多进程
• 显存不足 → 启用梯度检查点或切换 QLoRA
• UI 延迟 → 调低 logging_steps 或升级 Gradio

第四层：预防性设计

• 所有数据预处理脚本独立运行并缓存结果
• 关键参数设置合理默认值（如 max_seq_length ≤ 2048）
• 训练前先做一次 dry-run 测试端到端连通性

Llama-Factory 的强大之处，不仅在于它整合了这么多先进技术，更在于它暴露了足够多的干预接口。你可以完全不用代码上手，也可以深度定制每一个模块。正是这种灵活性，让它成为目前最成熟的大模型微调工程框架之一。

掌握这套排查逻辑的意义，远不止解决一个进度条问题。它教会我们一种思维方式：在高度抽象的工具背后，始终保留对底层机制的理解能力。当你不再被动等待'奇迹发生'，而是能主动诊断、干预、优化时，才算真正掌握了大模型工程化的钥匙。

未来的 AI 项目交付，拼的不再是会不会调参，而是能不能稳住训练流程。一次失败的训练可能让你损失数小时甚至数天的时间成本。而那些能够快速恢复、精准定位问题的人，才是真正推动项目落地的核心力量。

所以，下次再看到进度条不动，请先深呼吸，然后打开终端，输入那句熟悉的命令：

nvidia-smi

真相，往往就在那里等着你。