Python原始字节流转C++ Qt QIcon失败问题排查求助

核心问题分析 #

• Python端二进制转字符串的错误：PNG属于二进制数据，直接用str(thumbnail._raw_bytes)会把bytes按UTF-8解码成字符串，但二进制里大量字节不符合UTF-8规则，会被替换成乱码字符，导致传到C++的已经不是完整有效的PNG字节。
• C++端QByteArray初始化错误：QByteArray arr(); 这是声明了一个返回QByteArray的函数，不是创建对象，后续的arr.append操作完全无效，肯定加载失败。

修正方案 #

Python端代码修改 #

别把二进制bytes转成str，直接传bytes对象给C++，Boost Python可以直接把Python的bytes提取成std::string（std::string本身就是字节序列，能存二进制数据）：

data.rawBytes = thumbnail._raw_bytes  # 直接传递原始bytes，不做str转换

C++端代码修改 #

1. 修复QByteArray的初始化错误；
2. 正确处理二进制数据的转换；
3. 加个日志方便排查后续问题。

修正后的代码：

// 提取Python传来的bytes数据为std::string
std::string rawbytes = boost::python::extract<std::string>(obj.attr("rawBytes"));

// 正确创建QByteArray对象，不是函数声明
QByteArray arr;
// 用data()和size()，避免c_str()自动加的'\0'破坏二进制数据
arr.append(rawbytes.data(), rawbytes.size());

bool flag = pixmap.loadFromData(arr, "PNG");
if (!flag) {
    // 打印日志看数据长度，方便排查
    qDebug() << "PNG加载失败，数据长度：" << arr.size();
}

QStandardItem* item = new QStandardItem(name);
item->setIcon(QIcon(pixmap));

额外验证步骤 #

• 在Python端打印len(thumbnail._raw_bytes)，C++端打印rawbytes.size()，确认两个数字一致，说明数据没丢；
• 把C++拿到的rawbytes写入本地文件，用图片查看器打开，验证是不是有效PNG：

  std::ofstream out("test.png", std::ios::binary);
  out.write(rawbytes.data(), rawbytes.size());
  out.close();
  

  如果文件能正常打开，说明数据传输没问题，再查QPixmap的加载逻辑；如果打不开，说明数据在传输时损坏，回去检查Python端的字节传递。

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