从PostgreSQL bytea读取图片在PySide2 QDialog显示异常问题排查

我有一个将图片上传至PostgreSQL数据库的程序，图片以bytea类型存储。现在想实现反向功能：读取该图片并在PySide2 QDialog中展示，但显示的图片异常（如附图所示）。我的代码如下：

logoInfo = dbConn().query.first('''select encode(inhalt::bytea, 'escape')
    from database where bildname = $1 ''', string)
self.byteObj = bytes(self.logoInfo, 'utf-8')
self.imgQT = QImage(self.byteObj, 100, 100, QImage.Format_ARGB32)
self.pixmap = QPixmap.fromImage(self.imgQT)
self.label.setPixmap(self.pixmap)
self.label.show()

我认为存在编码/解码问题，希望排查代码中的错误。

你的代码存在三个核心问题，导致图片显示异常：

• bytea数据解码方式错误
  PostgreSQL的encode(inhalt::bytea, 'escape')会将二进制数据转换成转义格式的字符串（比如把\x00转成\\000），但你直接用bytes(..., 'utf-8')转成字节流，相当于把转义后的字符串重新编码，完全破坏了原始二进制数据。正确的做法是直接读取bytea的原始二进制，不需要用encode函数，或者用decode('unicode_escape')还原转义字符串为原始字节。

• 硬编码图片尺寸与格式
  你强制指定QImage的尺寸为100x100，并且固定格式为Format_ARGB32，但原始图片的尺寸和格式可能完全不同，这会导致图片数据被错误解析，出现乱码或变形。

• 缺少图片数据的正确加载逻辑
  QImage需要根据原始图片的格式（比如PNG、JPG）自动解析，而不是直接按固定像素格式加载二进制流。

修正后的代码 #

方案一：直接读取原始bytea数据（推荐）

修改SQL查询，去掉encode函数，直接获取bytea的原始二进制：

# 直接查询bytea类型的原始二进制数据
logoInfo = dbConn().query.first('''select inhalt from database where bildname = $1''', string)
if logoInfo:
    # 直接使用原始二进制数据创建QByteArray
    byte_array = QByteArray(logoInfo)
    # 让QImage自动解析图片格式
    self.imgQT = QImage.fromData(byte_array)
    if not self.imgQT.isNull():
        self.pixmap = QPixmap.fromImage(self.imgQT)
        self.label.setPixmap(self.pixmap.scaled(self.label.size(), Qt.KeepAspectRatio))
        self.label.show()

方案二：处理现有encode后的字符串（不推荐，仅适配旧数据）

如果必须使用encode(..., 'escape')的查询结果，需要先还原转义字符串为原始字节：

logoInfo = dbConn().query.first('''select encode(inhalt::bytea, 'escape') from database where bildname = $1''', string)
if logoInfo:
    # 将转义字符串还原为原始二进制
    raw_bytes = logoInfo.encode('latin-1').decode('unicode_escape').encode('latin-1')
    byte_array = QByteArray(raw_bytes)
    self.imgQT = QImage.fromData(byte_array)
    if not self.imgQT.isNull():
        self.pixmap = QPixmap.fromImage(self.imgQT)
        self.label.setPixmap(self.pixmap.scaled(self.label.size(), Qt.KeepAspectRatio))
        self.label.show()

关键说明 #

• 优先使用方案一，直接读取bytea原始数据，避免额外的编码转义操作，减少出错概率。
• 使用QImage.fromData()自动识别图片格式，无需手动指定尺寸和像素格式。
• 调用scaled()方法保持图片比例，避免拉伸变形，适配label的显示区域。

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