PySide2连接PostgreSQL查询触发内部错误，如何捕获该错误？

问题根源 #

QtSql模块中，部分底层数据库错误（比如查询不存在的表）不会被转化为Python可捕获的异常，而是直接触发Qt底层的致命错误，导致Python解释器崩溃终止。此外，如果没有显式检查QtSql方法的返回值、未绑定正确的数据库连接，会加剧这个问题。

解决方案 #

1. 启用Qt全局错误捕获 #

通过qInstallMessageHandler捕获Qt底层的错误日志，在崩溃前获取详细错误信息：

from PySide2.QtCore import qInstallMessageHandler, QtMsgType

def qt_message_handler(msg_type, context, msg):
    print(f"Qt错误[{msg_type.name}]: {msg}")

# 安装全局错误处理器
qInstallMessageHandler(qt_message_handler)

2. 严格检查每一步的返回值 #

QtSql的prepare()、exec()等方法都会返回布尔值，表示操作是否成功，必须先判断返回值再继续：

from PySide2.QtSql import QSqlDatabase, QSqlQuery

# 已建立的数据库连接
db = QSqlDatabase.database("your_connection_name")
query = QSqlQuery(db)  # 显式传入数据库连接，避免默认连接问题

sql_query = "SELECT * FROM non_existent_table"
if not query.prepare(sql_query):
    print(f"Prepare失败: {query.lastError().text()}")
    print(None)
else:
    if not query.exec():
        print(f"执行失败: {query.lastError().text()}")
        print(None)
    else:
        # 处理查询结果
        pass

3. 结合Python异常捕获与Qt错误信息 #

虽然Qt底层致命错误可能无法被Python的try-except捕获，但可以包裹Python层逻辑，同时通过lastError()获取Qt内部错误：

try:
    query = QSqlQuery(db)
    if not query.prepare(sql_query):
        print(f"Prepare错误: {query.lastError().text()}")
        print(None)
    elif not query.exec():
        print(f"执行错误: {query.lastError().text()}")
        print(None)
    else:
        # 处理查询结果
        pass
except Exception as e:
    print(f"Python异常: {str(e)}")
    print(None)

关键注意事项 #

• 必须显式将QSqlDatabase实例传递给QSqlQuery，避免默认连接的上下文混乱问题；
• 永远不要忽略prepare()和exec()的返回值，Qt不会主动抛出Python异常，错误信息只能通过lastError()获取；
• 全局错误处理器能帮你定位Python层看不到的底层问题，比如驱动加载异常、连接上下文错误等。

内容的提问来源于stack exchange，提问作者Dante S.