每个人都可以，
拥有SSL证书

搞 PaddleOCR 的时候，应该不少人都遇到过一上来就报 ImportError: numpy.core.multiarray failed to import 这类错误。后来查了一圈，基本都指向 NumPy 的版本问题。

这个坑不算深，但踩进去也挺耽误事的。

直接说结论：PaddleOCR 和它那几个核心依赖对 NumPy 的版本卡得很死。PaddlePaddle 2.6.x 要求 NumPy < 2.0，而 ultra-infer-gpu-python 1.1.1 也明确限制了 NumPy < 2。如果环境里已经是 NumPy 2.x，哪怕你装的过程没报错，跑起来还是会炸——主要是 NumPy 2 调整了底层 C API，有些扩展加载就直接失败了。

最常见的翻车现场是这样的：直接用 pip install numpy，不指定版本，就会拿到最新的 2.x 版本。或者是一次性安装 paddlepaddle paddleocr numpy==2.2.6，结果依赖打架。

报错信息除了上面那个 multiarray 导入失败，有时还会抛出 DependencyError，说 PDFReaderBackend 需要 opencv-contrib-python。这个其实也是版本不匹配的连锁反应。

所以最简单的办法就是把环境搞干净，然后一次性钉死版本。我这边一直在用的组合是：

conda create -n paddle_env python=3.10
conda activate paddle_env
pip install numpy==1.23.5 paddlepaddle==2.6.0 paddleocr==2.7.0.3 \
    opencv-contrib-python==4.6.0.66 -i https://pypi.tuna.tsinghua.edu.cn/simple

Python 3.10，NumPy 1.23.5，PaddlePaddle 2.6.0，PaddleOCR 2.7.0.3，OpenCV 4.6.0.66，这个组合在 Ubuntu 22.04 和 Windows 11 上都测过，稳定。

如果不想一口气装完，也可以分步来，先装 NumPy，再装 Paddle 生态，最后补 opencv：

pip install numpy==1.23.5
pip install paddlepaddle paddleocr --pre
pip install opencv-contrib-python==4.6.0.66

这样做的好处是万一中间哪步想单独降级或升级，比较好控制。

还有一个依赖锁定的办法，就是把上面那些版本写进 requirements.txt：

numpy==1.23.5
paddlepaddle==2.6.0
paddleocr==2.7.0.3
opencv-contrib-python==4.6.0.66

然后 pip install -r requirements.txt --no-cache-dir 一把梭。

加上 --no-cache-dir 是为了防止本地缓存里有别的版本干扰，线上部署的时候这个参数尤其有用。

装完之后怎么知道到底对不对呢？跑一下版本检查：

import numpy as np
import paddle
print(f"NumPy版本: {np.__version__}")   # 期待输出 1.23.5
print(f"Paddle版本: {paddle.__version__}")  # 期待输出 2.6.0

然后再写个最简单的 OCR 测试，拿张图片跑一下：

from paddleocr import PaddleOCR
ocr = PaddleOCR(use_angle_cls=False, lang="ch")
result = ocr.ocr("test.jpg")
print("识别成功" if result else "识别失败")

只要能正常走完，没有 ImportError，就说明版本兼容性已经没问题了。

要是还不行，想查到底哪个动态库有问题，可以在 Linux 下用 ldd 看看 numpy 那个 C 扩展链接了哪些 so：

ldd $(python -c "import numpy.core._multiarray_umath as m; print(m.__file__)")

Windows 用户可以用 where libopenblas.dll 检查一下相关 DLL 有没有缺失。

这种低级调试手段平时不常用，但真要定位到某个库加载失败时，比瞎猜管用。

说到预防，很多人会忽视环境隔离。用 conda 单独建个 ocr_env，不要往 base 环境里乱装东西，这个习惯能省很多麻烦。另外就是定期看一看哪些包已经过时了：

pip list --outdated
pip install --upgrade numpy paddlepaddle paddleocr

不过升级之前最好还是先查一下新版对 NumPy 的要求有没有放宽，免得刚从 1.x 解脱又掉回 2.x 的坑。

整个过程就是这样。PaddleOCR 的 NumPy 版本冲突本质上就是依赖约束没对上，用钉死版本的方式能解决绝大多数问题。以后遇到类似的情况，先别急着怀疑代码，把几个核心包的版本对齐，大概率就好了。