qsqlpsql.dll 的核心功能与缺失影响

qsqlpsql.dll 是 Qt SQL 模块在 Windows 平台下的 PostgreSQL 数据库驱动插件，对应驱动名为 QPSQL。它本身不是 PostgreSQL 服务端组件，也不是通用数据库客户端，而是 Qt 应用程序与 PostgreSQL 客户端库 libpq 之间的动态桥接层。应用程序通过 QSqlDatabase、QSqlQuery、QSqlTableModel 等类访问 PostgreSQL 时，Qt 会在插件目录中查找并加载 qsqlpsql.dll，再由该 DLL 完成底层协议适配。

核心功能

• 驱动注册与动态加载：实现 Qt 插件接口，使 QSqlDatabase::addDatabase('QPSQL') 能够创建有效连接对象。若插件缺失，QSqlDatabase::drivers() 不会返回 QPSQL。
• 连接与认证：解析 host、port、dbname、user、password、sslmode、options 等参数，调用 libpq 建立 TCP/IP、Unix 域套接字或 SSL 加密连接，并处理认证握手。
• SQL 执行与预处理：将 QSqlQuery::exec、prepare、bindValue、addBindValue 等调用映射为 PostgreSQL 语句执行，支持参数绑定，降低 SQL 注入风险。
• 事务与提交回滚：实现 QSqlDatabase::transaction、commit、rollback，保证业务数据的一致性。
• 结果集与元数据：把 PostgreSQL 返回的行、列、字段类型、表名、影响行数等信息转换为 Qt 的 QSqlResult、QSqlRecord、QVariant 结构，供模型/视图和业务代码读取。
• 错误映射：将 libpq 错误信息、SQLSTATE、连接失败原因封装为 QSqlError，便于程序统一处理。
• 类型与编码转换：处理 PostgreSQL 的 text、varchar、int、numeric、timestamp、bytea 等类型与 Qt 数据类型的转换，以及客户端编码设置。

缺少 qsqlpsql.dll 可能的影响

在 Windows 部署时，qsqlpsql.dll 通常应位于应用程序目录下的 sqldrivers 子目录，并与 Qt 的架构、编译器版本保持一致。若使用 PostgreSQL 客户端库，还需确保 libpq.dll 及其依赖（如 SSL、加密库）可用。排查时可先检查 QSqlDatabase::drivers() 输出，再确认插件路径、依赖项和版本兼容性。