You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

树莓派安装OpenCV后执行import cv2报错缺少共享库无法导入问题求助

树莓派OpenCV Python导入报错解决方案

你的两次报错均为OpenCV运行所需的系统动态链接库依赖未安装完全导致,按以下步骤操作即可彻底解决:

步骤1:修复当前libavresample.so.3缺失问题

执行以下命令安装对应依赖包:
sudo apt-get update && sudo apt-get install -y libavresample-dev
安装完成后可先测试import cv2是否正常,若仍有其他.so文件缺失提示,继续执行下一步补全所有依赖。

步骤2:批量安装OpenCV全量运行依赖

一次性补齐OpenCV所需的所有系统依赖,避免后续再出现同类缺失问题:

sudo apt-get install -y libjpeg-dev libtiff5-dev libpng-dev \
libavcodec-dev libavformat-dev libswscale-dev libv4l-dev \
libxvidcore-dev libx264-dev \
libgtk2.0-dev libgtk-3-dev \
libatlas-base-dev gfortran libhdf5-dev libhdf5-serial-dev \
libqtgui4 libqtwebkit4 libqt4-test python3-pyqt5

步骤3:验证修复效果

执行以下命令测试导入是否正常:
python3 -c "import cv2; print(cv2.__version__)"
如果正常输出版本号即为修复成功。

异常排查

如果执行完上述操作仍报错,按以下项核对:

  • 版本兼容校验:你当前使用的是Python3.5,对应Raspbian Stretch旧系统,最新版OpenCV已经不再支持Python3.5,会出现依赖不兼容问题,此时需安装适配Python3.5的最后一个OpenCV版本:
    pip3 install opencv-python==4.2.0.34
  • 版本冲突校验:确认你执行Python测试的版本和安装OpenCV的pip版本对应,执行pip3 -V查看pip绑定的Python版本,和你运行测试代码的Python版本保持一致即可。

内容的提问来源于stack exchange,提问作者Mattster89

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.25 06:45:03