PaddleOCR运行ocr.ocr()时Jupyter内核崩溃重启问题求助

算力阿峰

2026-7-16

解决PaddleOCR执行ocr.ocr()导致Jupyter内核崩溃重启的问题

排查内存不足问题
PaddleOCR加载检测、识别及角度分类模型会占用大量内存，Jupyter内核因内存耗尽崩溃是常见情况。关闭后台无关程序释放内存，或在启动Jupyter时通过--NotebookApp.max_memory_usage参数设置内存上限（需根据自身硬件调整）。
调整PaddleOCR版本与依赖
版本不兼容可能引发内核崩溃。尝试安装稳定版本：
```
pip install paddleocr==2.6.1.3
```
同时确保PaddlePaddle版本与PaddleOCR匹配，通过pip list查看numpy、opencv-python等依赖库版本，升级或降级至兼容版本。
修改初始化参数降低负载
先简化参数测试是否仍崩溃：
```
from paddleocr import PaddleOCR, draw_ocr

# 关闭角度分类、减少识别批量
ocr = PaddleOCR(use_angle_cls=False, lang='en', use_gpu=False, rec_batch_num=1)
result = ocr.ocr(img_path)
```
如果简化后正常，再逐步开启角度分类等功能，同时可调整det_db_unclip_ratio等参数优化内存占用。
排查Jupyter环境问题
在普通Python脚本中运行相同代码，若脚本正常执行，说明是Jupyter内核问题。尝试更新Jupyter：
```
pip install --upgrade jupyter ipykernel
```
或更换Python内核版本（比如从3.10切换到3.8），重新安装内核：
```
python -m ipykernel install --user --name=python38
```
系统与硬件适配调整
Windows系统下可尝试关闭多进程：
```
ocr = PaddleOCR(use_angle_cls=True, lang='en', use_gpu=False, use_multiprocess=False)
```
Linux系统需确保安装了必要的系统依赖，比如libgl1-mesa-glx，可通过对应包管理器安装。