将MedianBlur放入子函数时触发OpenCV断言错误问题咨询

这个cv2.error的核心是**medianBlur函数的输入不符合要求**：它要求输入图像必须是8位无符号整数类型（对应OpenCV的CV_8U，即numpy的uint8），且通道数只能是1（灰度图）、3（RGB）或4（RGBA）。

针对你说的“仅代码结构拆分就触发错误”的情况，大概率是拆分后的子函数逻辑里存在你没注意到的图像格式变更，常见的几个坑：

• 子函数中无意引入了浮点型图像
  比如在子函数里做了归一化、除法等运算，把图像转换成了float32/float64类型，但没转回到uint8就传给medianBlur。举个例子：

  # 子函数中的错误操作
  def sub_func(img):
      img = img / 255.0  # 转成0-1的浮点型
      # 后续直接调用medianBlur，触发断言错误
      return cv2.medianBlur(img, 3)
  

  哪怕你事后检查了最终输入，也可能漏看中间步骤的格式转换。

• 多进程场景下的序列化问题
  你的函数名是use_subprocesses，如果是用multiprocessing创建子进程，直接传递OpenCV的Mat对象可能会因为pickle序列化丢失格式信息——比如反序列化后的numpy数组dtype被意外修改，或者通道结构混乱。

• 图像传递时的原地修改
  如果子函数里对传入的图像做了原地修改（比如cv2.cvtColor(img, cv2.COLOR_BGR2GRAY, dst=img)），在循环调用的场景下，可能会导致后续图像的格式被意外改变。

排查步骤 #

1. 在调用medianBlur的前一行，强制打印图像的关键参数，对比两个函数的输出：

   # 打印格式信息
   print(f"图像类型: {img.dtype}, 通道数: {img.shape[2] if len(img.shape)==3 else 1}")
   

   这一步肯定能找到两个流程的差异点。
2. 如果是多进程场景，不要直接传递Mat对象，先转成numpy数组，或者用编码解码的方式传递：

   # 子进程间传递图像的正确方式
   _, img_encoded = cv2.imencode('.png', img)
   # 传递img_encoded到子进程后，再解码
   img_decoded = cv2.imdecode(img_encoded, cv2.IMREAD_COLOR)
   

3. 逐行检查子函数中的图像操作，确保每一步后图像仍然是uint8类型，通道数符合要求。

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