Qt 6.9.0连接远程MySQL数据库报错:qsqlmysql loaded library but QMYSQL driver not loaded
嘿,我之前也踩过几乎一样的坑,结合你的环境(Windows11 + Qt6.9.0 llvm-mingw64 + 远程CentOS MySQL8.0.41),给你梳理几个最可能的排查方向,一步步来:
先盯紧libmysql.dll的细节
你从mysqld安装包提取的libmysql.dll,首先要确保是64位版本(和你的Qt llvm-mingw_64完全匹配),而且版本必须和服务器端MySQL8.0.41大版本一致。另外,MySQL8.0的libmysql.dll依赖两个关键的SSL库:libcrypto-3-x64.dll和libssl-3-x64.dll,这俩文件一定要和libmysql.dll一起复制到你的程序运行目录里,我当初就是漏了这俩,折腾了好久。检查驱动编译的兼容性
你编译qsqlmysql驱动的时候,用的是不是Qt自带的llvm-mingw1706_64工具链?必须保证编译驱动的编译器和你编译项目的编译器完全一致,不然会有二进制不兼容的隐形问题。另外,编译时qmake的参数有没有正确指向MySQL的头文件和库路径?比如qmake命令应该类似这样:qmake "INCLUDEPATH+=C:/path/to/mysql/include" "LIBS+=C:/path/to/mysql/lib/libmysql.lib" mysql.pro编译完成后,要确认生成的qsqlmysql.dll确实放到了
C:/Qt/6.9.0/llvm-mingw_64/plugins/sqldrivers/目录,而且这个目录的读写权限没问题。排查运行时依赖缺失
用Qt自带的windeployqt工具处理一下你的程序目录,它会自动复制所需的Qt运行时库,避免因为缺少mingw的运行时库(比如libgcc_s_seh-1.dll、libstdc++-6.dll)导致驱动加载失败。也可以用Dependency Walker打开qsqlmysql.dll,看看有没有红色标记的缺失依赖,直接定位问题。别忘了远程MySQL的配置
服务器端的MySQL得允许远程连接才行:- 编辑CentOS上的my.cnf(或my.ini),把
bind-address改成0.0.0.0(允许所有IP访问)或者你Windows机器的具体IP; - 给你的数据库用户授权远程访问权限,执行SQL命令:
GRANT ALL PRIVILEGES ON your_database.* TO 'your_username'@'your_windows_ip' IDENTIFIED BY 'your_password'; FLUSH PRIVILEGES; - 确保CentOS的防火墙开放了3306端口,或者临时关闭防火墙测试一下。
- 编辑CentOS上的my.cnf(或my.ini),把
用好QT_DEBUG_PLUGINS的日志
你已经开了QT_DEBUG_PLUGINS=1,运行程序时控制台会输出详细的插件加载日志,重点找包含QMYSQL或load library的错误信息,比如“Cannot resolve symbol”或者“Missing dependent library”,这些日志能直接告诉你到底是哪一步出了问题,比瞎猜管用多了。
内容来源于stack exchange




