Qt for Python绑定仅22行SQL表格后GUI操作异常卡顿是什么原因？

你遇到的卡顿是PyQt操作SQL数据库时的常见问题，核心原因有3个：

• QODBC驱动默认预取行数过低，滚动表格时会反复触发数据库请求产生网络往返延迟
• 数据库连接、查询模型定义为局部变量，运行结束后被Python垃圾回收，后续UI访问数据时会触发异常等待
• 缺少数据库操作的错误校验，隐性的连接/查询失败会阻塞UI线程

具体修复步骤 #

1. 把数据库连接、模型改为实例属性 #

在变量前加self.前缀，避免被GC回收，生命周期和窗口保持一致。

2. 调整查询预取行数 #

显式设置QSqlQuery的prefetchLimit，避免每次滚动都请求数据库。

3. 增加数据库操作的错误校验 #

及时捕获连接、查询失败的问题，避免无意义的阻塞。

修改后的可运行代码 #

import example
from PyQt5.QtSql import QSqlDatabase, QSqlQueryModel, QSqlQuery
from PyQt5 import QtWidgets
import sys

class window(example.Ui_MainWindow):
    def __init__(self, MainWindow):
        super().__init__()
        self.setupUi(MainWindow)
        
        # 改为实例属性，避免被GC回收
        self.db = QSqlDatabase.addDatabase('QODBC', 'DGCR')
        self.db.setDatabaseName("DRIVER={SQL Server};SERVER=**add server name here**;DATABASE=DGCR;Trusted_Connection=Yes;")
        
        # 增加连接错误校验
        if not self.db.open():
            print("数据库连接失败：", self.db.lastError().text())
            return
        
        q = """SELECT * FROM dbo.table"""
        # 显式构造QSqlQuery，设置预取行数
        query = QSqlQuery(q, self.db)
        query.setForwardOnly(True) # 正向查询，性能更高
        query.setPrefetchLimit(1000) # 一次性拉取1000行，覆盖你的22行数据
        
        # 模型改为实例属性
        self.model = QSqlQueryModel()
        self.model.setQuery(query)
        
        # 增加查询错误校验
        if self.model.lastError().isValid():
            print("查询失败：", self.model.lastError().text())
            return
        
        self.tableView.setModel(self.model)

if __name__ == '__main__':    
    app = QtWidgets.QApplication(sys.argv)
    MainWindow = QtWidgets.QMainWindow()
    ui = window(MainWindow)
    MainWindow.show()
    sys.exit(app.exec_())

额外优化建议 #

如果你的需求就是展示单表全量数据，可以直接用QSqlTableModel替代QSqlQueryModel，内部对表格展示场景做了更多优化，代码更简洁：

self.model = QtSql.QSqlTableModel(MainWindow, self.db)
self.model.setTable("dbo.table")
self.model.select()
self.tableView.setModel(self.model)

内容的提问来源于stack exchange，提问作者Ricardo Corrales Barquero