int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    QpVariantMap map1;
    QpVariantMap map2;

    map2.insert("key_before", "ok");

    map1.insert("map2", map2);

    map2.insert("key_after1", "ok"); // так не правильно

    // так сработает и "key_after2" добавится в map2
    QVariant &vmap2 = map1["map2"];
    QVariantMap map_2 = vmap2.toMap();
    map_2.insert("key_after2", "ok");
    map1.insert("map2" , map_2 );


    qDebug()<< "---------------------------------";
    qDebug()<< "map1 "<< QtJson::serialize1( map1 );
    qDebug()<< "---------------------------------";

   return 0;
}
вывод на экран:
---------------------------------
map1  "{
    "map2": {
        "key_after2": "ok",
        "key_before": "ok"
    }
}"
---------------------------------

#ifndef QPMAP_H
#define QPMAP_H

#include <QMap>
#include <QVariantMap>
#include <QString>
#include "common/json/my_json.h"

template <class Key, class T>
class QpMap : public QMap<Key,T>
{
public:
    QpMap():QMap<Key,T>(){};
    

    // -----------------------------------------------------------------
    // addToMap добавляет в QVariantMap ключ/значение на любой уровень
    // вложенности дерева QVarinatMap
    // -----------------------------------------------------------------

    bool addtoMap( const QStringList &lst,
                   const QString & key,
                   const QVariant & val,
                   bool createKey_IfNotExist = true)
    {
        QpMap<QString,QVariant> *pMap  = this;

        foreach( QString name , lst)
        {

            QVariantMap::Iterator it1 = pMap->find(name);

            if( it1 != pMap->constEnd()) // именно mmm->constEn...
            {
                // ---------------------------------------------------
                // если ключ СУЩЕСТВУЕТ получим ссылку на него в куче
                // ---------------------------------------------------

                if( it1.key() != name)
                {
                    return false;
                }

                if( ! getPtr ( it1.value() , &pMap ) ) // переставляем указатель на следующий QVariantMap
                    return false;

            }
            else if ( createKey_IfNotExist )
            {
                // -------------------------------------------
                // если ключ ЕЩЕ НЕ СУЩЕСТВУЕТ создадим его
                // -------------------------------------------

                pMap->insert( name, QpVariantMap() );
                //pMap->insert( name, new QpVariantMap() ); // можно и так

                QVariantMap::Iterator it2 = pMap->find(name);

                if( it2 != constEnd() && it2.key() == name)
                {
                    if( ! getPtr ( it2.value() , &pMap ) ) // переставляем указатель на следующий QVariantMap
                        return false;
                }
                else
                {
                    return false;
                }
            }
            else
            {
                return false;
            }
        }
        // на выходе устанавливаем ключ значение в контейнере дерева

        //*mmm->insert(key, val); // ИЗМЕНИЛИ/ДОБАВИЛИ НОВЫЙ ЭЛЕМЕНТ !!!
        pMap->insert(key, val); //  странно но работает и так ????

        return true;
    }

    bool getPtr( QVariant &var, QpMap<QString,QVariant> **pMap)
    {
        // ---------------------------------------------------
        // приведение типа
        // ---------------------------------------------------

        *pMap = reinterpret_cast<QpMap<QString,QVariant>*>( var.data());

         QVariant *vv = reinterpret_cast<QVariant*>( var.data() );

        if(! vv->isValid() || ! vv->canConvert( QVariant::Map))
            return false;


        // проверили это  QVariantMap
        return true;
    }
};

typedef QpMap<QString,QVariant> QpVariantMap ;

#endif // QPMAP_H

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    QpVariantMap map1;
    QpVariantMap map2;

    map2.insert("key_before", "ok");

    map1.insert("map2", map2);

    // так сработает и "key_after2" добавится в map2
    QVariant &vmap2 = map1["map2"];
    QVariantMap map_2 = vmap2.toMap();
    map_2.insert("key_after2", "ok");
    map1.insert("map2" , map_2 );

    map1.addtoMap( QString("map2").split(","), "key_after1" , "ok" );  // ТЕПЕРЬ ТАК РАБОТАЕТ!
    map1.addtoMap( QString("m2,m3,m4").split(","), "key_after1" , "ok" );  // И ТАК РАБОТАЕТ!

    qDebug()<< "---------------------------------";
    qDebug()<< "map1 "<< QtJson::serialize1( map1 );
    qDebug()<< "---------------------------------";

   return 0;
}
вывод
---------------------------------
map1  "{
    "m2": {
        "m3": {
            "m4": {
                "key_after1": "ok"
            }
        }
    },
    "map2": {
        "key_after1": "ok",
        "key_after2": "ok",
        "key_before": "ok"
    }
}"
---------------------------------