Ubuntu 20.04LTS中Jupyter Notebook导入OpenCV报libGL.so.1缺失的解决问询

问题根因 #

• 系统终端Python3能正常导入cv2，说明系统层面的OpenCV包、libGL动态库文件本身已经存在，不存在实际文件缺失的问题。
• 报错核心原因是Snap商店安装的Jupyter运行在封闭沙箱环境中，启动时会主动裁剪系统动态库的搜索路径，默认不会开放对系统层面/usr/lib目录下共享库的读取权限，导致cv2加载自身依赖的libGL.so.1时找不到对应文件。
• 此前在Jupyter内两次执行pip安装命令都提示依赖满足，是因为pip检测到用户目录下已经安装过opencv-python包，但沙箱的环境隔离导致包加载时依赖读取失败，属于典型的“包已安装但权限不通”的场景。

分步修复操作 #

• 第一步：补全系统层面的OpenCV基础依赖
  终端执行以下命令，安装opencv-python运行必需的系统组件，排除基础依赖缺失的问题：
  sudo apt install libgl1-mesa-glx libglib2.0-0
• 第二步：放开Snap沙箱的必要访问权限
  终端执行以下命令，开放对桌面OpenGL组件、用户目录资源的访问限制，重启Jupyter后重新尝试导入cv2：
  snap connect jupyter-notebook:desktop-opengl
snap connect jupyter-notebook:home
• 第三步：权限调整无效时替换为无隔离的Jupyter安装方式
  如果沙箱权限配置后仍无法正常导入cv2，可卸载Snap渠道的Jupyter，直接通过系统Python的pip安装同版本服务：
  sudo snap remove jupyter-notebook
pip3 install jupyter notebook
  这种方式安装的Jupyter和终端Python3共享完整的系统运行环境，不存在沙箱隔离导致的权限裁剪问题，所有系统Python下可正常导入的第三方库都能直接识别。

Python、Jupyter安装库与操作系统的交互逻辑 #

• 通过pip安装的第三方库并非纯Python代码，多数包含预编译好的C/C++二进制模块，这类模块不是独立可运行的程序，必须依赖操作系统层面安装的通用共享库才能正常加载。
• pip包管理器本身只会安装Python层面的文件，不会自动帮用户安装系统级别的依赖组件，遇到动态库加载报错时，优先排查系统依赖缺失、运行环境的权限/隔离限制，而非反复重装Python包。
• 不同渠道安装的Jupyter环境隔离度差异极大：系统pip安装的Jupyter和终端Python共享完整系统环境；Snap、Flatpak渠道安装的Jupyter默认运行在封闭沙箱内，所有跨沙箱的资源访问都需要显式授权，很容易出现“终端可正常运行、Jupyter内报错”的不对称问题。

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