使用QSortFilterProxyModel按角色排序时QDateTime字段排序失效如何解决

核心错误点 #

1. 未主动触发排序
   QSortFilterProxyModel不会自动执行排序逻辑，必须显式调用sort()方法才会触发lessThan执行。你的初始化代码中缺少排序触发调用，这是lessThan从未被调用的最直接原因。
2. 自定义lessThan取数逻辑错误
   你重写的lessThan方法调用data()时未传入排序角色，默认取的是Qt::DisplayRole的值，就算触发排序也拿不到DateTimeRole的正确比较值。
3. （可选排查）未正确注册自定义角色
   如果你的SimpleModel没有重写roleNames()方法注册DateTimeRole，代理模型无法正确读取对应角色的值，也会导致排序异常。

修复步骤 #

1. 初始化代理模型时新增排序触发调用，修改main.cpp代码：

SimpleModel m;
ProxyModel proxyModel;
proxyModel.setSourceModel(&m);
proxyModel.setSortRole(SimpleModel::SimpleRoles::DateTimeRole);
// 新增此行，ListModel只有一列，指定对第0列排序
proxyModel.sort(0, Qt::AscendingOrder);
engine.rootContext()->setContextProperty("simpleModel", &proxyModel);

2. 修正lessThan的取数逻辑，或直接删除自定义lessThan：
   QSortFilterProxyModel默认的lessThan原生支持QDateTime类型比较，只要你正确设置了sortRole，完全不需要自己重写lessThan。如果要保留自定义实现，修改代码如下：

bool ProxyModel::lessThan(const QModelIndex &source_left, const QModelIndex &source_right) const
{
    qDebug() << "called lessThan()";
    // 传入当前设置的排序角色读取数据
    QVariant leftData = sourceModel()->data(source_left, sortRole());
    QVariant rightData = sourceModel()->data(source_right, sortRole());

    if (leftData.userType() == QMetaType::QDateTime) {
        return leftData.toDateTime() < rightData.toDateTime();
    }
    // 非DateTime类型走父类默认逻辑
    return QSortFilterProxyModel::lessThan(source_left, source_right);
}

3. 检查SimpleModel的roleNames()实现，确认DateTimeRole已正确注册，示例参考：

QHash<int, QByteArray> SimpleModel::roleNames() const
{
    QHash<int, QByteArray> roles;
    roles[NameRole] = "name";
    roles[DateRole] = "date";
    roles[TimeRole] = "time";
    roles[DateTimeRole] = "dateTime";
    return roles;
}

排查方向 #

• 新增sort调用后先看lessThan的调试输出是否打印，如果没有打印，检查源模型数据更新时是否正确调用了beginInsertRows/endInsertRows、dataChanged等标准通知方法，代理模型只有感知到源模型数据变化才会触发重排。
• 如果调试输出已打印但排序结果不对，打印leftData和rightData的值，确认是否能正确拿到QDateTime类型的数据，排查角色注册、取数逻辑的问题。

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