重装系统后Python人脸识别项目libxcb.dll加载失败求助

环境信息 #

• Python版本：3.9.0
• GTK3 Runtime版本：gtk3-runtime-3.24.31-2022-01-04-ts-win64
• 系统：64位Windows

问题描述 #

1. 因病毒攻击导致系统重装，恢复Git仓库中未使用虚拟环境的人脸识别Python项目
2. 执行pip install -r requirements.txt安装依赖全程无报错
3. 首次运行项目提示找不到cairo相关库，安装gtk3-runtime win64版本后解决该问题
4. 重启项目后触发新错误：

OSError: cannot load library 'libxcb.dll': error 0x7e. Additionally, ctypes.util.find_library() did not manage to locate a library called 'libxcb.dll'

已尝试操作 #

• 安装gtk3-runtime win64版本
• 搜索相关错误但未找到有效解决方案

解决方案 #

方法1：添加GTK3 Runtime路径到系统环境变量 #

gtk3-runtime的bin目录未加入系统PATH会导致动态库无法被识别：

1. 定位gtk3-runtime安装路径，默认路径为C:\Program Files\GTK3-Runtime Win64\bin
2. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
3. 在系统变量的Path列表中添加上述bin目录
4. 重启命令行或IDE后重新运行项目

方法2：手动复制libxcb.dll到可识别目录 #

1. 在gtk3-runtime的bin目录中找到libxcb.dll文件
2. 将其复制到Python的DLLs目录（例如C:\Python39\DLLs），或项目根目录
3. 重新运行项目

方法3：更换GTK3 Runtime版本 #

当前使用的2022年版本可能存在兼容性问题，尝试安装更稳定的新版本（如gtk3-runtime-3.24.40-2023-08-24-ts-win64），安装后重复方法1的环境变量配置步骤

方法4：修复Python依赖版本冲突 #

部分依赖库与GTK3 Runtime版本不匹配也会触发该错误：

1. 卸载现有冲突库：pip uninstall pycairo pygobject
2. 安装适配Python3.9与GTK3.24的版本：pip install pycairo==1.20.0 pygobject==3.42.0

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