Qt从QJsonObject读取QJsonArray异常问题求助

我之前在Qt 5.x项目里也碰到过类似的诡异JSON解析问题，尤其是在处理嵌套数组的时候。咱们一步步拆解问题，找到靠谱的解决办法：

首先排查JSON字符串构造的隐性问题 #

你的测试代码里用字符串拼接构造JSON，虽然看起来没问题，但Qt的QJsonDocument::fromJson对某些转义或拼接细节可能敏感。建议换成C++11支持的原始字符串字面量，彻底避免转义错误：

const QString jsonRawStr = R"(
{
  "o1" : {
    "i1" : ["l1", "l2", "l3"],
    "i2": 3.14
  },
  "o2" : {
    "i2": 2.718,
    "i1" : ["l1", "l2", "l3"]
  }
}
)";
auto document = QJsonDocument::fromJson(jsonRawStr.toUtf8());

你可以先打印原始JSON字节流，确认传递给解析器的内容完全正确：

qDebug() << "Raw JSON content:" << jsonRawStr.toUtf8();

采用防御式读取（非Hack的核心方案） #

永远不要假设JSON的键一定存在、类型一定符合预期——这是避免这类奇怪问题的最佳实践。我通常会封装安全读取的工具逻辑，或者直接在代码里做逐层校验：

if (document.isObject()) {
    QJsonObject docObj = document.object();
    
    // 检查o1是否存在且为对象
    if (docObj.contains("o1") && docObj["o1"].isObject()) {
        QJsonObject o1 = docObj["o1"].toObject();
        
        // 检查i1是否存在且为数组
        if (o1.contains("i1") && o1["i1"].isArray()) {
            QJsonArray i1Array = o1["i1"].toArray();
            qDebug() << "Valid i1 array:" << i1Array;
            
            // 读取数组元素时同样校验类型
            if (!i1Array.isEmpty()) {
                QJsonValue firstItem = i1Array.at(0);
                if (firstItem.isString()) {
                    qDebug() << "i1[0] value:" << firstItem.toString();
                } else {
                    qWarning() << "Unexpected type for i1[0], got:" << firstItem.type();
                }
            }
        } else {
            qWarning() << "Key 'i1' missing or not an array";
        }
    } else {
        qWarning() << "Key 'o1' missing or not an object";
    }
} else {
    qWarning() << "JSON document is not an object";
}

针对你遇到的嵌套数组问题的临时兼容 #

如果确认JSON本身没问题，但Qt 5.14.2确实出现了数组被意外嵌套的bug（这个版本确实有一些小的JSON解析瑕疵），可以在工具函数里加一层兼容处理，但这只是临时方案，建议优先升级到Qt 5.15.x（如果项目允许）：

QJsonArray safeGetArray(const QJsonValue& val) {
    if (val.isArray()) {
        QJsonArray arr = val.toArray();
        // 检查是否是意外嵌套的单元素数组
        if (arr.size() == 1 && arr.first().isArray()) {
            qWarning() << "Detected unexpected nested array, auto-fixing";
            return arr.first().toArray();
        }
        return arr;
    }
    qWarning() << "Value is not an array";
    return {};
}

// 使用方式
QJsonArray i1Array = safeGetArray(o1["i1"]);

总结 #

1. 先确保JSON源的正确性，用原始字符串避免转义坑
2. 防御式编程，每次读取都校验键存在性和数据类型
3. 若确认为Qt版本bug，优先考虑升级；临时兼容时加明确的日志提示，避免后续维护混乱

内容的提问来源于stack exchange，提问作者Cúthalion