跨QThread操作QAbstractListModel更新QML ListView报错如何解决

问题根因 #

QAbstractListModel属于UI关联对象，所有修改模型结构的操作（包括beginInsertRows/endInsertRows、beginRemoveRows/endRemoveRows这类触发QML视图更新的接口）必须在模型所属的主线程执行。你在子线程直接调用模型的addPerson方法，相当于跨线程触发模型更新信号，Qt元对象系统无法跨线程队列传递QQmlChangeSet类型，因此抛出对应错误。

解决方案 #

核心思路是子线程只负责CPU密集计算、数据生成，修改模型的操作全部放到主线程执行，修改步骤如下： #

1. 修改ThreadHandler逻辑，删除模型指针依赖，新增信号传递生成好的数据集

threadhandler.h修改

#ifndef THREADHANDLER_H
#define THREADHANDLER_H

#include <QObject>
#include "personmodel.h" // 要包含Person结构体定义

class ThreadHandler : public QObject
{
    Q_OBJECT
public:
    explicit ThreadHandler(QObject *parent = nullptr);

public slots:
    void process();

signals:
    void finished();
    // 新增信号，传递子线程生成的Person列表
    void personsGenerated(QList<Person*> persons);

private:
    void doPrimes();
    int calculatePrimes(int inRepeat);
};

#endif // THREADHANDLER_H

threadhandler.cpp修改

void ThreadHandler::process()
{
    qDebug() << Q_FUNC_INFO << "thread handler starts";

    // 仅保留CPU密集计算逻辑
    calculatePrimes(3);

    int row = 5;
    QList<Person*> persons;
    QString strLastNameIndex;
    for (int i = 0; i < row; i++)
    {
        strLastNameIndex = QString::number(i);
        Person* person3 = new Person();
        person3->First = "Bob" + strLastNameIndex;
        person3->Last  = "LastName" + strLastNameIndex;
        persons.append(person3);
    }
    // 发信号将数据集传递到主线程
    emit personsGenerated(persons);

    qDebug() << Q_FUNC_INFO << "row count: " << row;
    emit finished();
    qDebug() << Q_FUNC_INFO << "thread handler ends";
}

2. 修改PersonModel，新增批量添加数据的槽函数

personmodel.h修改

public slots:
    void requestPersonData(void);
    void requestDeleteAll();
    bool remove(const int inIndex);
    // 新增槽函数，主线程执行批量添加数据
    void addPersons(QList<Person*> persons);

personmodel.cpp修改

// 实现新增的批量添加槽
void PersonModel::addPersons(QList<Person*> persons)
{
    if (persons.isEmpty()) return;
    int startRow = _people.count();
    int endRow = startRow + persons.count() - 1;
    // 主线程操作模型，不会触发跨线程问题
    beginInsertRows(QModelIndex(), startRow, endRow);
    _people.append(persons);
    endInsertRows();
    emit countChanged();
}

// 修改requestPersonData的信号槽绑定
void PersonModel::requestPersonData()
{
    QThread* pPThread = new QThread();
    ThreadHandler* pHandler = new ThreadHandler();

    pHandler->moveToThread(pPThread);

    connect(pPThread, SIGNAL(started()), pHandler, SLOT(process()));
    // 绑定子线程数据信号到主线程模型的添加槽
    connect(pHandler, SIGNAL(personsGenerated(QList<Person*>)), this, SLOT(addPersons(QList<Person*>)));

    // 自动回收线程和handler对象
    connect(pHandler, SIGNAL(finished()), pHandler, SLOT(deleteLater()), Qt::QueuedConnection);
    connect(pPThread, SIGNAL(finished()), pPThread, SLOT(deleteLater()), Qt::QueuedConnection);

    pPThread->start();
}

// 修复析构函数内存泄漏
PersonModel::~PersonModel()
{
    qDeleteAll(_people);
    _people.clear();
}

3. 修复已知隐患

你当前main.cpp中初始添加的person1、person2是栈变量，模型存储的是指针，析构时会尝试释放栈内存导致崩溃，修改为堆分配即可：

// main.cpp修改初始数据部分
Person* person1 = new Person();
person1->First = "Bob";
person1->Last  = "One";

Person* person2 = new Person();
person2->First = "Bob2";
person2->Last  = "Two";

mymodel.addPerson(person1);
mymodel.addPerson(person2);

大数据量场景优化建议 #

如果单次加载数据量超过1000条，可做如下优化避免UI卡顿：

• 分页加载：每次只加载当前视图可见范围内的几十条数据，滚动时动态加载更多
• 增量更新：将大批次数据拆分为多组，每次插入少量数据，分散UI更新压力
• 自定义缓存：如果数据来源是数据库，可新增中间缓存层，按需读取数据到模型

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