使用 Nvidia 官方 Docker 镜像折腾 Stable Video Diffusion 的时候，发现 OpenCV 社区有一个古怪的 issue 需要手动解决，所以顺手写了一个能够自动修复的小工具。

以及，聊聊如何快速的发布一个 Python 软件包。

写在前面

如果你在使用 Python 生态的软件时，遇到了 module 'cv2.dnn' has no attribute 'DictValue' 的报错，可以试试看这个小工具。

当然，如果你想进一步确认是因为 OpenCV 引起的问题，可以尝试执行下面的命令：

python -c "import cv2; print(cv2.__version__)"

如果你收获的不是某个版本号，而是下面的报错日志，说明你的 Python 软件包存在需要修复的问题。

Traceback (most recent call last):File "<string>", line 1, in <module>File "/usr/local/lib/python3.10/dist-packages/cv2/__init__.py", line 181, in <module>bootstrap()File "/usr/local/lib/python3.10/dist-packages/cv2/__init__.py", line 175, in bootstrapif __load_extra_py_code_for_module("cv2", submodule, DEBUG):File "/usr/local/lib/python3.10/dist-packages/cv2/__init__.py", line 28, in __load_extra_py_code_for_modulepy_module = importlib.import_module(module_name)File "/usr/lib/python3.10/importlib/__init__.py", line 126, in import_modulereturn _bootstrap._gcd_import(name[level:], package, level)File "/usr/local/lib/python3.10/dist-packages/cv2/typing/__init__.py", line 168, in <module>LayerId = cv2.dnn.DictValue
AttributeError: module 'cv2.dnn' has no attribute 'DictValue'

这个问题在社区早些时候有被反馈（opencv/opencv-python #884），主要原因是在安装 numpy 时被带入一起安装的版本过旧 opencv 导致的兼容性问题。比较 Trick 的是我们并不能通过简单执行 pip install 来更新软件包，需要遵从帖子进行一些手动清理安装，才能将问题解决。

所以，我写了一个简单的开源小工具，来自动修正这个问题，项目开源地址在：soulteary/opencv-fixer。

下面讲讲如何使用这个小工具。

OpenCV Fixer

工具的使用非常简单，和使用普通的软件包一样，使用 pip install 来完成工具包的下载：

pip install opencv-fixer==0.2.5

软件的修复需要进行 OpenCV 的清理和更新下载，如果你访问 Python 官方的 PyPi 源比较慢，可以顺手更新软件源为国内的镜像：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

然后，执行下面的命令，就能够完成 OpenCV 的自动修复工作了：

python -c "from opencv_fixer import AutoFix; AutoFix()"

如果一切正常，你将看到类似下面的日志输出：

Uninstalling the following OpenCV-related packages: opencv, opencv-fixerSuccessfully uninstalled opencvSuccessfully uninstalled opencv-fixerFound opencv-python version is lower than 4.9, version=4.7.0Begin upgrade your opencv-python version to 4.9+.The folder /usr/local/lib/python3.10/dist-packages/cv2 has been removed successfully...

如果我们再次执行之前的测试命令，能够得到 OpenCV 的版本号，那么说明一切都修复正常啦：

# python -c "import cv2; print(cv2.__version__)"
4.9.0

当然，如果我们在 Docker 环境或者使用 root 用户执行，可能会收到下面的 warning 警告日志：

Install opencv-python-headless failed: WARNING: Running pip as the 'root' user can result in broken permissions and conflicting behaviour with the system package manager. It is recommended to use a virtual environment instead: https://pip.pypa.io/warnings/venv

但其实是没有问题的，如果我们执行 pip show opencv-python-headless，能够看到软件已经被正确安装：

# pip show opencv-python-headless
Name: opencv-python-headless
Version: 4.9.0.80
Summary: Wrapper package for OpenCV python bindings.
Home-page: https://github.com/opencv/opencv-python
Author: 
Author-email: 
License: Apache 2.0
Location: /usr/local/lib/python3.10/dist-packages
Requires: numpy, numpy, numpy, numpy
Required-by: 

其他：快速发布一个 Python 软件包

想要快速发布能够被 pip install 安装的 Python 软件包，其实很简单。

首先，需要注册一个 PyPi 账号，注册完毕后，会要求我们验证邮箱有效性。再完成邮箱验证后，我们需要在账号中配置“二步认证”，从而开启获取 API Token 的权限。

获取的 API Token 页面下方，有可以一键复制的配置文件，内容类似下面这样，我们可以保存起来，稍晚使用：

[pypi]username = __token__password = pypi-一长串Token

如果你是 macOS 用户，在不配置或者更新本地 Python 环境的情况下，如果想直接发布一个软件包，可能会比较麻烦。但是如果使用 Docker 就会变的简单许多：

cd package-dirdocker run --rm -it -v `pwd`:/app python:3.10 bash

比如，使用上面的命令，可以快速的将软件包里的内容映射到 Python 3.10 容器的 /app 目录，方便我们用一个完备、干净的环境做软件发布。

发布过程中，我们可以配置软件源和完成依赖软件包的下载：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simplepip install packaging twine

完成基础依赖后，执行下面的命令，可以将我们之前获得的 API Token 保存为可以通过 PyPi 源认证的配置文件。

cat << EOF > ~/.pypirc
[pypi]username = __token__password = pypi-一长串Token
EOF

一切就绪之后，我们执行下面的命令，完成 Python 软件包的构建和发布就完事啦：

python setup.py sdist bdist_wheel
twine upload dist/*

最后

好了，这篇文章就先写到这里。

–EOF

---

本文使用「署名 4.0 国际 (CC BY 4.0)」许可协议，欢迎转载、或重新修改使用，但需要注明来源。 署名 4.0 国际 (CC BY 4.0)

本文作者: 苏洋

创建时间: 2024年01月07日
统计字数: 3707字
阅读时间: 8分钟阅读
本文链接: https://soulteary.com/2024/01/07/fix-opencv-dependency-errors-opencv-fixer.html