如何解决TensorFlow 2 Object Detection API训练时出现的UnicodeError
2026-10-4
问题根因
- 报错触发于TensorFlow读取检查点状态文件阶段，和你已经排查过的pipeline.config编码、执行命令、API安装状态无关
- 核心原因是
model_dir路径下的checkpoint索引文件损坏，大概率是预训练模型下载/解压过程中出错，或者之前训练中途中断残留了异常文件，导致utf-8解码失败
解决方案
- 清空模型目录残留内容：删除
models/my_ssd_mobilenet_v1_fpn_640x640_coco17_tpu-8下的所有文件，提前把你修改好的pipeline.config备份到其他路径避免丢失 - 重新处理预训练模型：重新下载对应预训练模型压缩包，避免下载中断导致文件损坏；不要使用Windows自带解压工具，换用7-Zip等专业工具解压，解压路径不要包含中文、空格、特殊符号
- 核对配置文件参数：把备份的pipeline.config放回模型目录后，确认
fine_tune_checkpoint参数指向的预训练检查点路径正确，fine_tune_checkpoint_type参数设置为detection - 强制Python使用UTF-8编码：Windows环境下运行训练命令前，先在当前终端执行
set PYTHONUTF8=1，避免系统默认GBK编码导致的兼容问题
验证操作
完成上述调整后直接运行你原来的训练命令即可正常启动训练。
内容的提问来源于stack exchange，提问作者Ryotaro Harada
相关产品推荐
相关产品推荐
