RecursionError: maximum recursion depth exceeded while calling a Python object。

[zycsola]

🔎 Search before asking

• I have searched the PaddleOCR Docs and found no similar bug report.
• I have searched the PaddleOCR Issues and found no similar bug report.
• I have searched the PaddleOCR Discussions and found no similar bug report.

🐛 Bug (问题描述)

,报错。RecursionError: maximum recursion depth exceeded while calling a Python object。训练检测模型的时候没有报错，训练识别模型的时候报错。

🏃‍♂️ Environment (运行环境)

win10 锐龙cpu，英特尔独显。

🌰 Minimal Reproducible Example (最小可复现问题的Demo)

python tools/train.py -c configs/rec/PP-OCRv3/ch_PP-OCRv3_rec.yml

[GreatV]

检查一下数据集格式，注意检测和识别数据集格式是不同的

[GreatV]

这个错误 RecursionError: maximum recursion depth exceeded while calling a Python object（Python 对象调用时超过了最大递归深度）通常是由于代码中出现了递归调用未正确终止，或者出现了无限递归循环。

根据你提供的信息，在训练识别模型（rec）时出现此错误，而训练检测模型没有问题，同时你也提供了运行命令：

python tools/train.py -c configs/rec/PP-OCRv3/ch_PP-OCRv3_rec.yml

结合 PaddleOCR 框架的特性，这个问题可能出现在以下几个方面：

🔍 可能原因分析：

1. 配置文件导致的递归错误
   PP-OCRv3 的配置文件是可以相互嵌套继承的（通过 base 配置），如果你在 config 中写了不正确的继承，可能会导致配置无限递归。例如 configs/rec/PP-OCRv3/ch_PP-OCRv3_rec.yml 如果包含 base: 又指向自己或者其他间接指向自身的 yaml，会造成递归崩溃。

建议查看该配置文件和其 base 的父级文件，比如：

• configs/rec/PP-OCRv3/ch_PP-OCRv3_rec.yml
• 它是否引用了 base 配置，并确保 base 链条中没有循环引用

2. 字典深拷贝逻辑不当
   PaddleOCR 中的配置文件一般通过 OmegaConf（或者旧版使用 yaml.load）加载为嵌套结构，若在某处使用 dict.update 或 dict.setdefault 自动初始化嵌套字段时写法不当（如 self调用自己）也会引起递归爆炸。

3. 高度嵌套的数据结构或 transform 处理逻辑
   识别模型中为了图像增强等，常会涉及复杂的数据预处理流程。如果你自定义了 Dataset 或 transform 配置不当（例如在 RecDataset 中循环引用了 transforms 或 image_reader），也可能造成无限递归。

✅ 建议解决方案：

1. 检查配置文件是否有环形引用：
   打开 configs/rec/PP-OCRv3/ch_PP-OCRv3_rec.yml 文件，确认其base字段是否正确，确保它只引用上级配置文件，且没有间接回到当前文件。你可以使用递归检测脚本来帮助识别 base 引用链是否成环。

2. 增加最大递归深度（不推荐作为根本解决）：
   在一些非严重情况下，你可以通过增加递归深度避开错误：

import sys
sys.setrecursionlimit(3000)

但这仅为临时绕过方案，根本还是要修复递归源头。

3. 添加打印帮助排查：
   你可以通过在 PaddleOCR 的 train.py 或其中引用的配置加载模块中加入打印（如 print(config)）帮助确认配置内容和层级深度。

4. 检查模型配置中的 transforms 是否有无限循环：
   特别是 configs/rec/PP-OCRv3 中的数据增强配置，如 RecAug.yaml 等，是否存在 transform 中的字段不断指向自己或反复加载。

🔗 相关问题参考：

虽然你提到查找过但未发现相似问题，不过值得再次确认的相关 Issue：

• cuDNN 错误相关（不是直接导致 recursionError 的原因，但运行环境相符）：
  Issue 运行python tools/train.py -c pretrain_models/ch_PP-OCRv3_rec_distillation.yml报错，CUDNN_STATUS_INTERNAL_ERROR错误 #14228: 运行python tools/train.py -c pretrain_models/ch_PP-OCRv3_rec_distillation.yml报错，CUDNN_STATUS_INTERNAL_ERROR错误 #14228

📌 小结：

错误 RecursionError: maximum recursion depth exceeded 很可能是由于配置文件间 base 字段的环形引用造成的。建议从 configs/rec/PP-OCRv3/ch_PP-OCRv3_rec.yml 开始，检查其所有上级 base 文件中是否有循环引用。你也可以尝试在全新环境下使用官方默认 yaml 配置作为对比，逐步还原你当前的配置，找出递归源头。

如果问题持续无法解决，建议你将完整的 ch_PP-OCRv3_rec.yml 和所有引用的 base 文件整理打包发到社区以便他人协助进一步排查。

---

Response generated by 🤖 feifei-bot | chatgpt-4o-latest

⚠️ This is an AI-generated response. Please verify any critical information.