QMultiMap以QVariant为key时用QByteArray查询返回全部值问题

核心底层逻辑 #

QMap/QMultiMap属于有序关联容器，内部基于红黑树实现，判断两个键是否等价的规则为 !(键A < 键B) && !(键B < 键A)，而非直接调用==运算符判断相等。
当键类型为QVariant时，排序和等价判断完全依赖QVariant::operator<的实现：

• 若两个QVariant的元类型不同，部分Qt版本会直接返回false而非按元类型ID排序，此时所有不同类型的QVariant都会被判定为等价
• 若两个QVariant的元类型相同，会调用对应类型的比较逻辑，但若对应类型的头文件未完整引入，可能导致比较逻辑失效，始终返回false

两个问题的具体原因 #

1. 调用values传入字符串字面量返回所有值 #

你直接调用map.values("\xc2\x39\xc7\xe1")时，传入的参数是const char*类型，会隐式构造出QString类型的QVariant，而你插入的键是QByteArray类型的QVariant，二者元类型不同。
按上述QVariant比较逻辑，不同元类型的QVariant互相比对都会返回false，因此所有存储的QByteArray类型键都会被判定为和查询键等价，最终返回map中所有值。

2. 改用QMap仅能插入一个元素 #

你插入的两个键都是QByteArray类型的QVariant，元类型相同，但你大概率没有引入<QByteArray>头文件，仅通过其他头文件的前置声明得到了QByteArray的不完整定义。此时QVariant在调用QByteArray的比较逻辑时找不到正确的实现，无论两个QByteArray内容是否相同，QVariant::operator<都会返回false。
因此!(b1 < b2) && !(b2 < b1)的结果为true，两个键被判定为等价，QMap不允许重复键，所以仅能成功插入第一个元素。 #

修复方案 #

• 所有涉及QByteArray操作的位置，必须引入完整的<QByteArray>头文件
• 插入和查询键时，必须保证QVariant的元类型完全一致，查询时显式构造QByteArray再包装为QVariant：

  // 正确查询写法
  QStringList values = map.values(QVariant::fromValue(QByteArray("\xc1\x39\xc7\xe1")));
  

• 若业务场景允许，优先避免使用QVariant作为Map的键，直接指定明确的键类型如QMultiMap<QByteArray, QString>，从根源避免类型不匹配问题。

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