使用pip安装deepface时触发AssertionError错误求助

问题背景 #

系统配置：

• OS：POP-OS 22.04
• Python：3.10.12
• Pip：22.0.2

执行pip install deepface或源码安装（pip install -e .）时，均触发如下AssertionError：

ERROR: Exception:
Traceback (most recent call last):
  File "/usr/lib/python3/dist-packages/pip/_internal/cli/base_command.py", line 165, in exc_logging_wrapper
    status = run_func(*args)
  File "/usr/lib/python3/dist-packages/pip/_internal/cli/req_command.py", line 205, in wrapper
    return func(self, options, args)
  File "/usr/lib/python3/dist-packages/pip/_internal/commands/install.py", line 389, in run
    to_install = resolver.get_installation_order(requirement_set)
  File "/usr/lib/python3/dist-packages/pip/_internal/resolution/resolvelib/resolver.py", line 188, in get_installation_order
    weights = get_topological_weights(
  File "/usr/lib/python3/dist-packages/pip/_internal/resolution/resolvelib/resolver.py", line 276, in get_topological_weights
    assert len(weights) == expected_node_count
AssertionError

解决方案 #

这个错误是pip 22.x版本的依赖解析器存在已知bug导致的，升级pip即可解决：

步骤1：升级pip到最新版本 #

执行命令：

pip install --upgrade pip

如果遇到权限问题，可添加--user参数（仅为当前用户安装）：

pip install --upgrade pip --user

步骤2：重新安装deepface #

升级完成后，再次执行安装命令：

pip install deepface

备选方案：使用虚拟环境（避免系统依赖冲突） #

如果升级系统pip后仍有问题，建议使用虚拟环境隔离依赖：

1. 创建虚拟环境：

python3 -m venv deepface_env

2. 激活虚拟环境：

source deepface_env/bin/activate

3. 升级虚拟环境内的pip：

pip install --upgrade pip

4. 安装deepface：

pip install deepface

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