ImportError: libopencv_hdf.so.4.5缺失导致ROS Python项目导入cv2失败求助

错误原因 #

该报错是由于手动编译安装OpenCV时缺少HDF相关依赖，编译生成的共享库不完整，且覆盖了原有Python环境的cv2绑定，同时编译后的库文件未正确注册到系统动态链接路径中。

修复步骤 #

• 第一步：清理所有残留的OpenCV安装文件
  1. 卸载pip安装的OpenCV包

  pip3 uninstall opencv-python opencv-contrib-python -y
  

  2. 删除手动编译安装到/usr/local路径下的OpenCV文件

  sudo rm -rf /usr/local/include/opencv4
  sudo rm -rf /usr/local/lib/libopencv*
  sudo rm -rf /usr/local/lib/cmake/opencv4
  sudo rm -rf /usr/local/lib/python3.8/dist-packages/cv2
  

  3. 清理系统apt源安装的OpenCV残留

  sudo apt purge libopencv* python3-opencv -y
  sudo apt autoremove -y
  

• 第二步：重新安装Python版本OpenCV
  直接通过pip安装对应版本的预编译包，无需手动编译：

  pip3 install opencv-python==4.5.5.62
  

  安装完成后执行以下命令验证安装是否正常：

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

  正常输出版本号即代表Python OpenCV环境已修复。

代码额外修正 #

你当前的ROS代码存在发布类型不匹配的问题，定义的发布者目标消息类型为String，但实际发布的是Image类型数据，运行时会触发类型错误，需要将发布者定义修改为：

pub = rospy.Publisher('TestOps/Camera', Image, queue_size=10)

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