树莓派4 Python3.9环境安装OpenCV报错缺少libIlmImf依赖求解

你遇到的报错核心是两个问题：1. 前期apt安装的opencv和pip安装的版本路径冲突，导致apt装的cv2模块无法被你的Python环境识别；2. pip默认拉取的opencv-python预编译包未适配树莓派ARM架构，缺失对应版本的系统依赖库。

解决步骤 #

1. 清理所有已安装的冲突opencv版本 #

# 卸载用户级别pip安装的opencv
pip uninstall opencv-python opencv-python-headless -y
# 卸载全局pip安装的opencv
sudo pip uninstall opencv-python opencv-python-headless -y
# 卸载apt安装的opencv相关包
sudo apt remove python3-opencv python-opencv libopencv* -y
# 清理残留依赖
sudo apt autoremove -y
sudo apt update

2. 安装缺失的系统依赖 #

你报错里找不到的libIlmImf-2_5.so.25属于OpenEXR组件，直接安装对应依赖包即可：

sudo apt install libopenexr25 libatlas3-base libgstreamer-plugins-base1.0-dev -y

3. 安装适配树莓派的opencv-python #

两种方案二选一即可，优先选方案1，兼容性最好：

方案1：使用树莓派官方源适配版本（推荐）

sudo apt install python3-opencv -y

如果用了虚拟环境，需要保证虚拟环境创建时开启了继承全局包的权限，创建虚拟环境命令如下（如果是已有虚拟环境，删除重建即可）：

python3 -m venv --system-site-packages 你的虚拟环境名

方案2：pip安装适配ARM架构的指定版本

如果不想用全局包，直接在你的Python环境中安装适配Python3.9的稳定版本：

pip install opencv-python==4.5.5.62 --no-use-pep517

4. 验证安装 #

执行以下命令，正常输出版本号即说明安装成功：

python3 -c "import cv2; print(cv2.__version__)"

验证完成后再运行你的监控代码即可正常加载cv2模块。

内容的提问来源于stack exchange，提问作者Asian noob