使用YOLO训练自定义目标检测时出现Wrong annotation类ID范围报错
YOLO自定义训练class_id范围报错排查与解决
报错本质
系统给出的合法class_id范围为[from 0 to 0],代表当前训练配置仅声明了1个检测类别——按照YOLO的类ID从0起始计数的规则,唯一合法的类ID取值就是0,标注文件里出现的ID为1的条目,不存在对应的注册类别,因此触发校验报错。
常见诱因
- 标注工具的导出规则不匹配:部分标注工具默认类序号从1开始计数,导出YOLO格式标注时未做0起始的格式适配,直接输出了偏移后的类ID值。
- 类别配置与标注实际不匹配:标注过程中实际使用了2个类别的标签,但训练端加载的类别配置文件没有同步补充第二个类的条目,导致系统识别的总类数和标注侧的类总数出现偏差。
- 训练参数配置错填:部分YOLO版本的.data配置文件中单独设置了
classes参数,若该值填写为1,但标注实际使用了2类,也会触发同样的范围校验报错。
分步解决操作
- 核对训练端的类别配置
打开训练路径下的类别配置文件(通常为data/obj.names),逐行统计条目数;同时检查对应.data配置文件里的classes参数值:如果文件仅包含1行类名、classes参数值为1,说明系统识别的总类数为1,合法类ID范围固定为0,所有标注文件中非0的类ID都属于非法值。 - 定位问题标注的实际内容
打开报错提示的两个问题文件:data/obj/20210221_112732.txt、data/obj/20210221_112744.txt,逐行检查开头的第一个数值字段(也就是类ID字段),确认存在值为1的错误条目。标注格式提醒:YOLO单条标注的结构为
class_id x_center y_center width height,只有行首的第一个字段是类ID,后续0-1范围内的坐标值不会触发类范围校验报错。 - 按实际训练需求修正
- 如果你的训练目标仅为单类检测:所有标注出的目标都属于同一类,直接把问题文件里行首值为1的类ID改成0即可。也可以通过批量文本替换脚本,对
data/obj目录下所有标注文件的行首错误类ID做统一修正。 - 如果你的训练目标为双类检测:
class_id=1的标注确实对应第二个待检测类别,就在data/obj.names文件里补充第二个类的名称条目,同时修改.data文件里的classes参数值为2,保证类配置文件的总行数、参数值和标注中实际出现的最大class_id值+1相等——比如标注里最大的class_id是1,配置侧就需要匹配2类的设置,系统校验时的合法类范围会自动更新为[0 to 1]。
- 如果你的训练目标仅为单类检测:所有标注出的目标都属于同一类,直接把问题文件里行首值为1的类ID改成0即可。也可以通过批量文本替换脚本,对
- 修正后复校验
重新启动训练流程,等待系统完成全量标注文件的校验环节,确认没有同类类范围报错后,再进入正式训练阶段。
内容的提问来源于stack exchange,提问作者user12501158
相关产品推荐
相关产品推荐

