PyQt5创建PostgreSQL数据库时QPSQL驱动未加载问题求助

首先，咱们先理清楚你遇到的核心问题：虽然QSqlDatabase.drivers()显示QPSQL是可用驱动，但实际加载时还是报错，这通常是因为驱动的依赖库没找对，或者位数不匹配导致的。另外bash和cmd的输出顺序差异是Qt日志输出通道的问题，咱们一个个解决。

一、核心驱动加载问题的解决方案 #

1. 确认PyQt5和PostgreSQL的位数完全匹配 #

这是最容易被忽略的点：如果你的Python是64位，那PostgreSQL必须也是64位；如果是32位，PostgreSQL也要对应32位。位数不匹配的话，就算复制了dll也加载不了。你可以通过以下命令查看Python位数：

import sys
print(sys.maxsize > 2**32)  # True是64位，False是32位

然后对应检查PostgreSQL的版本位数（安装目录里一般会标，比如PostgreSQL\15\bin里的程序位数）。

2. 正确配置PostgreSQL的依赖库 #

你之前只复制了libpq.dll，但它还依赖其他库（比如PostgreSQL bin目录下的libcrypto-xxx.dll、libssl-xxx.dll等，具体文件名根据你的PostgreSQL版本而定）。推荐两种方式：

• 方式一：直接添加PostgreSQL的bin目录到系统PATH
  把PostgreSQL\你的版本号\bin（比如C:\Program Files\PostgreSQL\15\bin）添加到系统环境变量PATH的最前面（避免和其他版本的库冲突），然后重启你的终端和Python编辑器，再运行测试代码。
• 方式二：复制所有必要的dll到PyQt5的Qt/bin目录
  把PostgreSQL bin目录下的libpq.dll、libcrypto-xxx.dll、libssl-xxx.dll、libiconv-2.dll这些文件全部复制到Python目录\Lib\site-packages\PyQt5\Qt\bin里，覆盖已有的同名文件（如果有的话）。

3. 验证驱动加载状态 #

修改你的测试代码，在添加数据库后立即检查错误，确认驱动是否真的加载成功：

import sys
from PyQt5.QtSql import *
from PyQt5.QtWidgets import *

app = QApplication(sys.argv)

# 先打印可用驱动
print("Available drivers:", QSqlDatabase.drivers())

db = QSqlDatabase.addDatabase("QPSQL")
# 检查添加驱动时的错误
add_error = db.lastError().text()
if add_error:
    print("Error adding driver:", add_error)

db.setHostName('<Host>')
db.setDatabaseName('<Name>')
db.setUserName('<Username>')
# 如果有密码的话加上这行
# db.setPassword('<Password>')

ok = db.open()
if ok:
    print("OK, database is open")
else:
    print("Open error:", db.lastError().text())

sys.exit(app.exec_())

二、关于bash和cmd输出顺序的问题 #

Qt的日志提示（比如QSqlDatabase: QPSQL driver not loaded）是输出到标准错误(stderr)，而Python的print()是输出到标准输出(stdout)。在bash里，stderr和stdout默认是混在一起输出的，而且stderr的优先级更高，所以会先显示Qt的日志；而cmd里会分别处理这两个流，所以输出顺序符合你的代码逻辑。

如果你想在bash里让输出顺序正常，可以在运行脚本时把stderr重定向到stdout：

python your_script.py 2>&1

或者在代码里自定义Qt的日志处理函数，把日志输出到stdout：

from PyQt5.QtCore import qInstallMessageHandler, QtMsgType

def qt_message_handler(mode, context, message):
    if mode == QtMsgType.QtInfoMsg:
        print(message)

# 在创建QApplication之前设置日志处理器
qInstallMessageHandler(qt_message_handler)

app = QApplication(sys.argv)
# 后面的代码不变

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