GCP Ubuntu虚拟机运行PyQt5代码遇依赖库缺失问题求助

你遇到的情况很典型——通过SSH连接的无头Ubuntu服务器（无图形界面的虚拟机）缺少PyQt5 QtWebEngine组件所需的底层GUI系统依赖。安装窗口管理器只是提供了窗口管理环境，但基础的X11、OpenGL及其他图形相关系统库仍有缺失，这就是为什么解决一个依赖问题后又出现新的报错。

直接一步到位安装所有必要的系统依赖包就能彻底解决：

1. 先更新系统包列表：

   sudo apt update
   

2. 安装QtWebEngineWidgets需要的全部依赖：

   sudo apt install libgl1-mesa-glx libxss1 libx11-xcb1 libxcb-dri3-0 libgbm1 libasound2 libnss3
   

我给你拆解下这些包的作用：

• libgl1-mesa-glx：补上你最初缺失的OpenGL核心库（libGL.so.1）
• libxss1：解决你后来遇到的libXss.so.1缺失问题
• libx11-xcb1、libxcb-dri3-0：QtWebEngine依赖的X11窗口系统相关组件
• libgbm1：无头环境下支持图形缓冲区渲染的必要库
• libasound2：WebEngine组件可能用到的音频相关依赖
• libnss3：WebEngine的浏览器内核需要的网络安全服务库

安装完成后，你可以先测试导入是否成功：

python -c "from PyQt5 import QtWebEngineWidgets; print('Import successful!')"

另外，因为你是在SSH连接的无头虚拟机上运行GUI程序，即使依赖都装好了，直接运行可能还是会报错找不到显示设备。这时候可以用xvfb-run来模拟虚拟显示环境，运行你的PyQt脚本时可以这样：

xvfb-run python your_pyqt_script.py

如果需要长期使用虚拟显示，也可以配置Xvfb开机自启，或者使用其他类似的虚拟显示工具（比如Xvnc）。

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