OpenCV add()操作出现异常dtype与形状问题求助

问题场景 #

使用OpenCV 4.8.0执行cv2.add对两个uint8类型的1D数组求和时，未执行预期的饱和运算（结果应为255），反而输出超界值260，且结果形状异常为(4,1)的浮点数组。该问题在本地VSCode的Jupyter Notebook和py文件中复现，但在Google Colab中运行正常。

代码示例：

import numpy as np
import cv2

x = np.array([250], np.uint8)
y = np.array([10], np.uint8)

print(cv2.add(x, y))

实际输出：

[[260.]
[ 0.]
[ 0.]
[ 0.]]

预期输出：

[[255]]

解决方案 #

方案1：将输入数组改为2D格式

OpenCV的图像处理函数默认期望输入为2D数组（对应单通道图像的行×列结构），将1D数组改为2D后可直接修复该问题：

import numpy as np
import cv2

x = np.array([[250]], np.uint8)  # 改为2D数组格式
y = np.array([[10]], np.uint8)

print(cv2.add(x, y))  # 输出 [[255]]

方案2：重新安装官方预编译的OpenCV包

该异常可能源于本地OpenCV的编译配置bug，通过重新安装官方标准包可解决：

1. 卸载现有OpenCV相关包：

pip uninstall -y opencv-python opencv-contrib-python

2. 安装指定版本的官方预编译包：

pip install opencv-python==4.8.0

问题原因分析 #

在部分特定编译配置的OpenCV 4.8.0版本中，处理1D uint8数组时存在两个关键bug：

• 函数错误地将1D数组识别为4通道数组，导致输出形状变为(4,1)
• 计算过程未按uint8类型执行饱和运算，而是使用浮点类型直接求和，从而出现超界值260

Google Colab中的OpenCV采用标准编译配置，不存在该bug，因此运行结果正常。

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