TravisCI已安装python3-pyqt5但无法导入PyQt5的问题求助

问题背景 #

在Travis CI的Ubuntu 20 LTS环境中执行Python单元测试时，触发ImportError: No module named PyQt5错误。已尝试在.travis.yml的before_install和install阶段执行sudo apt install python3-pyqt5（优先方案），以及pip install pyqt5/pip install -U pyqt5，均未解决问题。本地Ubuntu 20 LTS虚拟机中执行sudo apt install python3-pyqt5后可正常导入PyQt5，推测问题与Travis CI的虚拟环境或特有机制有关。另外，必须避免通过pip安装PyQt5——ppc64le架构下PyQt5 5.15.0会触发AttributeError: module 'sipbuild.api' has no attribute 'prepare_metadata_for_build_wheel'构建错误。

解决思路 #

• 匹配Python版本并禁用虚拟环境
  Travis默认会为Python项目创建独立虚拟环境，而python3-pyqt5是Ubuntu系统自带Python（3.8版本）的包。若测试指定的Python版本与系统版本不一致，虚拟环境无法直接调用系统级PyQt5。可在.travis.yml中显式指定系统匹配的Python版本，并禁用虚拟环境：

  python:
    - "3.8"
  virtualenv: false
  

• 验证安装与路径一致性
  在before_script阶段添加命令，确认PyQt5安装状态及测试用Python路径：

  before_script:
    - sudo apt install -y python3-pyqt5
    - python3 -c "import PyQt5; print(PyQt5.__file__)" # 检查系统Python能否导入
    - which python # 查看测试用Python的路径
  

  若系统Python能导入但测试用Python不能，说明两者路径不匹配，需调整测试使用的解释器为系统Python。

• 手动添加系统PyQt5路径到搜索路径
  若必须使用虚拟环境，可通过环境变量或测试代码将系统PyQt5的默认路径（/usr/lib/python3/dist-packages）添加到Python的搜索路径：
  方式一（环境变量）：

  env:
    - PYTHONPATH="/usr/lib/python3/dist-packages:$PYTHONPATH"
  

  方式二（测试代码开头）：

  import sys
  sys.path.append('/usr/lib/python3/dist-packages')
  

• 修复APT源问题
  部分Travis镜像的APT源可能异常，导致python3-pyqt5安装不完整。可在before_install阶段切换到官方源：

  before_install:
    - sudo apt-get update --fix-missing
    - sudo apt-get install -y software-properties-common
    - sudo add-apt-repository -y main
    - sudo add-apt-repository -y universe
    - sudo apt-get update
    - sudo apt-get install -y python3-pyqt5
  

• 以sudo权限执行测试
  若虚拟环境无读取系统级包的权限，可尝试用sudo执行测试命令：

  script:
    - sudo python -m pytest # 替换为你的实际测试命令
  

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