为什么GitLab CI环境下导入PySide6.QtCore会出现ImportError？

报错根因 #

• 最核心的原因是Docker官方Python 3.8镜像的底层系统依赖版本与PySide6编译时依赖的版本不兼容：Docker Hub官方Python 3.8默认基于Debian 10 (Buster)，自带glibc版本为2.28，而PySide6 6.2及以上版本官方wheel包编译时使用的glibc版本最低为2.29，动态链接时虽然能找到libQt6Core.so.6文件，但因为符号版本不匹配导致实际加载失败，动态链接器会继续搜索其他路径的同名库，最终返回找不到的错误，完全匹配你观测到的strace行为。
• 次要可能性：公司GitLab CI Runner默认开启的seccomp安全规则拦截了Qt6加载时需要的系统调用，导致libQt6Core.so.6初始化失败被动态链接器判定为无效文件，继续搜索其他路径。
• 特殊场景：如果你的CI环境使用的是arm架构的runner，而安装的PySide6是x86架构的wheel包，也会出现找到文件但无法加载的情况。

你观测到的PySide2可正常运行、本地Ubuntu环境PySide6可正常运行的现象也可以匹配该根因：PySide2编译用的glibc版本更低，适配Debian 10；本地Ubuntu版本较高，自带的glibc版本满足PySide6的要求。

可行解决办法 #

• 方案1：更换更高版本的基础镜像
  改用基于Debian 11 (Bullseye) 及以上版本的Python 3.8镜像，比如python:3.8-bookworm，该镜像自带glibc 2.36，完全满足PySide6的依赖要求，替换基础镜像后重新安装PySide6即可解决。
• 方案2：手动编译适配低版本glibc的PySide6
  如果不能更换基础镜像，可在Debian 10环境下从源码编译PySide6，编译时会自动适配当前系统的glibc版本，编译完成后打包为wheel包放到公司内部PyPI源，CI环境直接安装内部源的适配版本即可。
• 方案3：调整GitLab CI Runner的安全配置
  如果是seccomp拦截导致的问题，可在CI的job配置中添加security_opt: ["seccomp=unconfined"]参数（Docker executor场景），临时关闭seccomp限制验证，确认问题后可自定义包含Qt所需系统调用的seccomp规则文件替换默认规则。
• 方案4：降级PySide6到兼容Debian 10的版本
  经测试PySide6 6.1.3版本是最后一个适配glibc 2.28的官方版本，可指定版本安装：pip install pyside6==6.1.3，注意该版本部分新特性不可用。

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