PyQt6升级到Qt6.2后QImage转QPixmap出现参数类型错误问题

核心原因 #

1. PyQt6已移除QPixmap直接接收QImage参数的构造方法，必须使用QPixmap.fromImage接口进行转换，沿用PyQt5的QPixmap(qt_image)写法会直接报错。
2. 调用QPixmap.fromImage仍提示参数类型不匹配，本质是传入的QImage实例与QPixmap类所属的Qt绑定模块不匹配，或QImage实例本身为无效/非法构造对象。

解决步骤 #

• 统一模块导入路径
  PyQt6中QImage与QPixmap均属于PyQt6.QtGui模块，需确保二者从同一模块导入，禁止混用PyQt6与PySide6的类，正确导入示例：

  from PyQt6.QtGui import QImage, QPixmap
  

• 校验QImage实例有效性
  转换前先判断QImage是否为正常构造的非空对象，避免空实例、格式异常的实例传入：

  if not qt_image.isNull():
      pixmap = QPixmap.fromImage(qt_image)
  

• 适配Qt6的类型转换规则
  若QImage从numpy数组、PIL图像等第三方格式转换而来，需确保转换时使用Qt6的枚举值，不要沿用PyQt5的旧写法，示例如下：

  # numpy数组转QImage（Qt6适配版）
  import numpy as np
  from PyQt6.QtGui import QImage, QPixmap
  
  # img为RGB格式的numpy数组
  img = np.random.randint(0, 255, (400, 600, 3), dtype=np.uint8)
  height, width, channel = img.shape
  bytes_per_line = channel * width
  qt_image = QImage(img.data, width, height, bytes_per_line, QImage.Format.Format_RGB888)
  pixmap = QPixmap.fromImage(qt_image)
  

• 升级依赖版本
  若以上步骤均无问题仍报错，升级PyQt6到最新稳定版：
  pip install --upgrade PyQt6 PyQt6-Qt6

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