Ubuntu下Python导入PyQt5 QtWebEngineWidgets报libgssapi_krb5.so.2缺失错误

可行解决方案 #

1. 校验库文件存在状态并修复动态链接缓存 #

• 首先执行命令查找库文件实际路径：
  find /usr/lib -name "libgssapi_krb5.so.2"
• 若命令有返回路径（例：/usr/lib/x86_64-linux-gnu/libgssapi_krb5.so.2），将路径添加到系统动态链接配置：
  echo "/usr/lib/x86_64-linux-gnu" | sudo tee /etc/ld.so.conf.d/libgssapi_fix.conf
• 刷新动态链接缓存：
  sudo ldconfig
• 重启Python程序验证是否修复。

2. 修复虚拟环境PyQt5版本兼容问题 #

PyPI源安装的PyQt5可能和当前系统版本不兼容，可改用系统源的PyQt5包：

• 退出虚拟环境，执行系统级安装：
  sudo apt install -y python3-pyqt5 python3-pyqt5.qtwebengine
• 打开虚拟环境根目录下的pyvenv.cfg文件，将include-system-site-packages参数值改为true
• 重新进入虚拟环境，卸载原有的PyQt5相关包后重试。

3. 用Conda环境规避系统依赖冲突 #

如果不想修改系统配置，可通过Miniconda/Anaconda创建运行环境，conda源的PyQt包会自带依赖的底层库，无需依赖系统的libgssapi组件：

• 进入conda环境后执行安装命令：
  conda install -y pyqt pyqtwebengine
• 运行程序验证即可。

4. 临时验证方案 #

如果需要快速验证问题根因，可在启动程序时手动指定库路径：
LD_LIBRARY_PATH=/usr/lib/x86_64-linux-gnu python Main.py
若可正常启动，说明问题出在动态链接缓存配置，按方案1永久修复即可。

特殊场景补充（Docker/容器环境） #

如果是在容器内运行，可额外安装krb5相关补充包：
sudo apt install -y krb5-user libkrb5-dev

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