GitLab CI运行pytest遇函数导入及PySide6依赖错误

一、初始AttributeError问题（模块找不到指定函数） #

核心原因 #

Linux文件系统严格区分大小写，而Windows不区分。本地Windows环境下，文件名大小写差异会被忽略，但GitLab的Linux Runner会严格校验：

• 测试脚本里的导入语句（比如后续出现的from Interceptor_module import isIPValid）和实际脚本文件名（最初提到的interceptor.py）大小写不匹配，导致导入的模块并非目标模块，自然找不到isIPValid函数。
• 其次可能是CI工作目录与本地不一致，Python无法定位到正确的模块路径。

解决步骤 #

1. 统一文件名与导入语句的大小写
   确保测试脚本的导入逻辑和实际文件名完全一致，比如脚本是interceptor.py，就用：

   import interceptor
   # 或者
   from interceptor import isIPValid
   

   彻底消除大小写差异带来的导入错误。

2. 校验CI工作目录
   在CI脚本中加入pwd命令查看当前路径，确保运行pytest时处于项目根目录。如果路径不对，可通过cd命令切换到正确目录。

3. 添加Python搜索路径
   在测试脚本开头添加以下代码，强制将当前目录加入Python模块搜索路径：

   import sys
   sys.path.insert(0, '.')
   

二、后续PySide6的ImportError问题（缺少libGL.so.1） #

核心原因 #

GitLab使用的python:3基础镜像（基于Debian/Ubuntu）未预装PySide6依赖的OpenGL系统库libGL.so.1，导致导入PySide6时触发缺失依赖错误。

解决步骤 #

1. 安装系统级依赖
   在CI脚本的Python包安装步骤前，添加系统依赖安装命令：

   apt-get update && apt-get install -y --no-install-recommends libgl1-mesa-glx
   

   （--no-install-recommends用于减少不必要的依赖，加快构建速度）

2. 优化CI脚本顺序
   调整CI脚本的执行顺序，先安装系统依赖，再处理Python虚拟环境和包安装：

   stages:       
     - test
   
   image: python:3
   
   unit-test-job:
     stage: test    
     script:
       - apt-get update && apt-get install -y --no-install-recommends libgl1-mesa-glx
       - python -m venv .venv
       - . .venv/bin/activate
       - pip install -r requirements.txt
       - pip install coverage pytest pytest-mock
       - echo "Running unit tests"
       - coverage run -m pytest
       - coverage report
       - coverage xml
   

3. 拆分无依赖模块（可选但推荐）
   既然isIPValid函数完全不依赖PySide6，建议将该函数拆分到独立的、无第三方依赖的模块（比如ip_utils.py）中，测试时直接导入这个轻量模块，彻底避开PySide6的复杂依赖问题，让单元测试更高效稳定。

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