QSqlRelationalTableModel设置关系后QTableView排序丢失数据问题

根因分析 #

当你为QSqlRelationalTableModel配置外键关联后，模型会自动生成JOIN关联表的SQL查询语句。默认点击表头触发排序时，模型仅会基于主表字段生成排序逻辑，如果排序字段是关联表字段、主副表存在同名字段、或者生成的SQL语句字段映射错误，都会导致查询失败，最终表现为表格数据全部丢失、无刷新。
如果移除setRelation调用，模型仅查询单表数据，不会触发JOIN查询的SQL语法问题，因此排序功能正常。

必要配置项 #

• 配置正确的编辑策略，避免关联场景下默认的单字段编辑策略导致排序异常，该配置需要在setRelation调用前完成：

# 可根据你的编辑需求选择OnRowChange或OnManualSubmit，不推荐使用默认的OnFieldChange
self.motormodel.setEditStrategy(QSqlTableModel.OnRowChange)

• 配置关联后设置JOIN模式，并重新执行查询，保证关联数据正常加载，避免空关联匹配导致数据过滤丢失：

self.motormodel.setRelation(1, QSqlRelation('Instruments', "Asset Tag","Description" ))
# 新增以下两行配置
self.motormodel.setJoinMode(QSqlRelationalTableModel.LeftJoin)
self.motormodel.select()

• 自定义关联列的排序逻辑，避免生成错误的排序SQL语句：
  默认模型排序仅识别主表字段，关联列排序需要指定关联表的字段名，可通过绑定表头点击信号实现：

def custom_sort(column, order):
    if column == 1: # 对应你设置了外键关联的列索引
        # 关联列排序指定关联表的字段
        self.motormodel.setSort(self.motormodel.relation(1).displayColumn(), order)
    else:
        self.motormodel.setSort(column, order)
    # 排序完成后必须重新执行查询拉取最新数据
    self.motormodel.select()

# 绑定表头点击触发自定义排序
self.ui.motorTableView.horizontalHeader().sectionClicked.connect(custom_sort)

• 避免使用QSortFilterProxyModel二次包装模型，除非你已经手动适配了关联列的排序/过滤逻辑，二次包装会打乱QSqlRelationalTableModel的字段映射关系，导致数据丢失。

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