简介Delphi 7 开发者连接 MySQL 5.7 时常因 libmysql.dll 与 dbxopenmysql50.dll 版本不配套而失败绝大多数网上流传的 dll 都无法直接使用。作者基于实际项目亲测将可用的两个核心动态库连同测试用例整理成此包并额外演示了数据库字段空值NULL与空字符串的判定区别对日常开发排错很有帮助。资源共 17 个文件以 dll、pas、dpr、dfm、sql、exe 等类型为主涵盖运行库、源码、可执行演示程序、初始化脚本及 dbExpress 面板可视化配置文档压缩包仅约 1.3MB结构紧凑。已有 821 人学习下载。发布时只需 libmysql、dbxopenmysql50 与 midas 三个库即可运行兼容 Windows XP 与 Windows 10适合需要快速搭建 DelphiMySQL 开发环境的中级开发者。 为了把一个上了年纪的老系统从 MySQL 5.1 迁到 5.7我上个月重新把 Delphi XE 的工程翻了出来。第一次跑起来程序直接弹窗提示找不到 dbxopenmysql50.dll。网上搜了一圈答案五花八门最后发现绕来绕去就是两个文件的事情dbxopenmysql50.dll 和 libmysql.dll。只要理解了这两个动态库在 dbExpress 里的分工再按正确的版本和位数去配置MySQL 5.7 其实没那么难连。这篇文章会从为什么需要这两个 DLL 讲起到如何获取、如何配置、如何排错把我实际踩过的坑和验证过的方案完整说一遍。1. 为什么是这两个 DLLdbExpress 连接 MySQL 5.7 的底层逻辑1.1 dbExpress 不是数据库驱动而是一套驱动框架我先举个例子。dbExpress 就像是一个“通用插座”MySQL、SQL Server、Oracle 都是不同规格的插头。为了能插进同一个插座每种数据库都需要一个适配器这个适配器在 dbExpress 里就是“驱动”。而dbxopenmysql50.dll正是负责 MySQL 的驱动适配器。它向 dbExpress 暴露统一的接口比如 getSQLDriverMYSQL让上层 TSQLConnection、TSQLQuery 完全不用关心底层是 MySQL 还是别的数据库。这一点对做通用报表程序很有价值切换数据库时代码几乎不用改。但对开发者的要求是你要知道驱动把真正干活的任务交给了谁。dbxopenmysql50.dll本身并不直接和 MySQL 服务器通信它只是一个翻译层把 dbExpress 的调用转换成 MySQL C API 的调用然后由客户端库去和服务器建立连接。1.2 两个动态库的分工协议翻译官和产品代言人可以这样理解dbxopenmysql50.dll是“翻译官”libmysql.dll是“产品本人”。翻译官负责把我们的话翻译成 MySQL 听得懂的方言但真正带着协议去敲门的人还是 libmysql.dll。MySQL 的 C API 库会处理 TCP/IP 连接、认证握手、SQL 发送、结果集接收这些底层细节。所以两者缺一不可没有 dbxopenmysql50dbExpress 不知道去哪个 DLL 找 MySQL 入口没有 libmysql驱动加载时会提示找不到依赖模块甚至直接崩掉。1.3 版本与位数匹配为什么这么敏感这里要特别提醒dbxopenmysql50.dll这个命名源自 MySQL 5.0很多人以为它只能连 MySQL 5.0其实它是针对 MySQL 5.x 系列设计的驱动入口库。Delphi XE 时代自带的这个 DLL 是在 MySQL 5.0/5.1 的 C API 上编译的用来连接 5.7 时官方的 C API 保持了很好的向后兼容所以通常能工作而且比很多第三方控件更稳。但有个前提两个 DLL 必须是同一个位数的版本。32 位程序里加载 64 位的 libmysql.dll会直接报“不是一个有效的 Win32 应用程序”反过来也一样。还有一个隐藏坑是 libmysql.dll 依赖的运行时库老版本的 libmysql 可能依赖 msvcr80.dll 或 msvcr100.dll部署到一台干净 Windows 机器时要一起带上不然 DLL 加载会静默失败。2. 拿到正确的 libmysql.dll 和 dbxopenmysql50.dll2.1 dbxopenmysql50.dll多数情况下不用额外下载如果装的是完整版 RAD Studio 或 Delphi这个文件已经在安装目录里。常见路径是C:\Program Files (x86)\Embarcadero\Studio\xxx\bin\dbxopenmysql50.dll。不同 IDE 版本带的驱动版本会有差异比如 Delphi XE 和 XE10 的驱动不一定能互换。这个文件是 Embarcadero 官方发布的一部分正常授权下使用即可。网上很多“MySQL 驱动压缩包”把这个文件单独打出来其实本质上就是从官方目录里提取的。如果不是从官方源提取我建议先去自己的 IDE 安装目录找一遍别急着从陌生网站下载毕竟 DLL 是要跟着程序分发到客户机器的来源不明的东西风险很大。2.2 libmysql.dll从官方渠道获取获取方式非常直接。第一种如果你本机已经装了 MySQL 5.7 服务器到安装目录的lib子目录找比如C:\Program Files\MySQL\MySQL Server 5.7\lib\libmysql.dll。第二种到 MySQL 官网下载 MySQL Community Server 5.7 的 ZIP 包解压后同样在lib目录拿到。第三种安装 MySQL Connector/C选择 32 位或 64 位组件安装完会在Program Files\MySQL\MySQL Connector C 6.1\lib下产出 libmysql.dll。我个人更倾向于从 ZIP 包提取因为它干净、不污染注册表版本也是你自己能控制的。需要注意libmysql.dll 有很多小版本客户端库版本最好和服务器版本接近。比如连 5.7.24 服务器用 5.7.44 的客户端库基本没问题但用 5.1 的客户端库去连虽然大部分功能可用却可能遇到认证协议、字符集兼容问题。2.3 放置位置与部署清单直接给一个我实际使用的清单表格场景DLL 放置位置补充说明开发机调试32位exe 输出目录如果还报错可以再看 Delphi bin 和 Windows SysWOW64部署机32位与 exe 同一目录推荐把两个 DLL 和 exe 放一起不依赖系统目录64位程序与 exe 同一目录需要对应的 64 位 DLL但老 Delphi 的 dbExpress 对 64 位支持有限建议先测试绿色便携版与 exe 同一目录不装 MySQL 也没关系libmysql.dll 只是客户端其实核心原则就一句话两个 DLL 都在 exe 同目录几乎不会再出现“找不到模块”的问题。不要图省事把所有 DLL 塞进 System32那样虽然自己的程序能跑但会让同一台机器上多个版本的 DLL 互相打架。发布时我习惯在工程脚本里加一个 postbuild 步骤把两个 DLL 复制到输出目录省得每次手动粘。3. 配置与连接让 TSQLConnection 正确找到两个 DLL3.1 驱动注册文件 dbxdrivers.ini 与 dbxconnections.inidbExpress 启动时会从 ini 文件读取驱动定义和连接定义。老版本 Delphi 里这些文件默认放在C:\Users\Public\Documents\Embarcadero\Studio\版本号\dbExpress之类的公共文档目录。dbxdrivers.ini负责说明每个驱动名对应哪个 DLL、哪个入口函数dbxconnections.ini则保存具体的连接参数。很多问题的根源是你改了连接参数却忘了检查驱动定义里的LibraryName和VendorLib。一个典型的 MySQL 驱动定义片段长这样[MySQL] GetDriverFuncgetSQLDriverMYSQL LibraryNamedbxopenmysql50.dll VendorLiblibmysql.dll Databasetestdb User_Nameroot Password123456 HostName127.0.0.1 BlobSize-1请注意LibraryName和VendorLib可以写成绝对路径但一旦发布到别的机器绝对路径就失效了。所以部署机上尽量用相对文件名并且把 DLL 放到 exe 同目录。3.2 代码连接示例如果你希望把配置逻辑写死在代码里可以像下面这样不依赖 ini 文件里的连接配置procedure TestMySQLConnection; var Conn: TSQLConnection; Qry: TSQLQuery; begin Conn : TSQLConnection.Create(nil); try Conn.DriverName : MySQL; Conn.GetDriverFunc : getSQLDriverMYSQL; Conn.LibraryName : dbxopenmysql50.dll; Conn.VendorLib : libmysql.dll; Conn.LoginPrompt : False; Conn.Params.Values[HostName] : 127.0.0.1; Conn.Params.Values[Port] : 3306; Conn.Params.Values[Database] : testdb; Conn.Params.Values[User_Name] : root; Conn.Params.Values[Password] : your_password; Conn.Params.Values[BlobSize] : -1; Conn.Open; Qry : TSQLQuery.Create(nil); try Qry.SQLConnection : Conn; Qry.SQL.Text : SELECT VERSION(), NOW(); Qry.Open; // 这里就可以从 Qry 里取字段了 finally Qry.Free; end; finally Conn.Free; end; end;有几个地方要留意。DriverName不是随便取的它要和驱动定义里的节名保持一致常见的是MySQL。GetDriverFunc要和LibraryName配对dbxopenmysql50.dll对应的入口就是这个字符串写错会在 Open 时报错。LoginPrompt : False是为了不让程序弹登录框否则部署到客户机器上没人输密码。代码里显式指定 LibraryName 和 VendorLib能跳过 ini 文件里的旧路径适合我们这种维护老项目的场景。3.3 手动设置字符集和其他连接参数除了基本参数遇到中文乱码时最关心的就是字符集。dbExpress 里可以在 Params 中加一项Conn.Params.Values[CharacterSet] : utf8mb4;但要注意老版本驱动可能不认识 utf8mb4此时客户端库和服务器协商的字符集名称要匹配。更稳妥的做法是连接建立后直接执行一句SET NAMES utf8mb4因为这条语句由 MySQL 服务器处理和驱动版本关系不大。实时操作时用Conn.ExecuteDirect(SET NAMES utf8mb4)即可。BlobSize 建议设为 -1这样 TSQLQuery 读取大字段时不会只取前面一小段。端口默认 3306如果服务器改过端口别只偷懒改连接串还要确认防火墙放行了对应端口。4. 常见问题与排查技巧实录4.1 找不到 DLL 或者模块加载失败这是最常见的错误。现象是 Open 时报 “Cannot load an IDAPI service library” 或直接丢出找不到指定模块。排查顺序我总结如下先确认两个 DLL 在 exe 同目录且文件不是 0 字节。打开任务管理器看进程到底是 32 位还是 64 位。路径上带(x86)的 Delphi 编译出的默认是 32 位程序加载 64 位 libmysql.dll 必然失败。用 Process Monitor微软 Sysinternals 的小工具过滤Process Name为自己的 exe在查看窗口里加Operation为CreateFile的过滤能看到程序启动时到底到哪个目录找 DLL、是否报NAME NOT FOUND。这一步能非常快速定位是路径问题还是文件缺失。如果路径和位数都对还报加载失败十有八九是 DLL 的依赖运行库缺失。把 VC 2005/2008/2010 运行库装上老项目基本都能跑起来。4.2 连接时提示无效授权 / Invalid license这个错误一出现很多人以为是 dbxopenmysql50.dll 的问题到处找“破解版驱动”非常危险。根据我的经验dbExpress 的 MySQL 驱动本身不会单独做授权校验它跟着 Delphi 的许可证走。如果你用的是正版 IDE驱动就是合法可用的如果你在系统里装过某些试用版第三方组件或改过系统时间才会在 IDE 或组件初始化时蹦出授权提示。正规做法是检查 IDE 激活状态、恢复系统时间、卸载可疑组件。实在不行绕开这条路换 FireDAC 反而省心。4.3 数据集打开状态下的“Cannot perform this operation on an open dataset”这个报错跟 DLL 无关但网上很多人搜索“delphi mysql”时会遇到。出错原因基本都一样在 TSQLQuery 或 TSQLDataSet 还处于 Open 状态时修改了连接参数、Change 了 SQL 文本、或者给 SQLConnection 换了新连接对象Delphi 认为这是非法操作。解决办法就是在修改前先 CloseQry.Close; // 先关闭数据集 Conn.Params.Values[Database] : newdb; // 再改参数 Qry.SQL.Text : SELECT * FROM new_table; Qry.Open; // 最后重新打开如果只是切换同一个 MySQL 实例上的数据库更推荐直接执行Qry.SQL.Text : USE newdb或建两个 TSQLConnection 分别管理省得反复开关连接。我在老项目里写过一段很破的连接复用代码就是因为没有 Close 老是在运行中报这个错后来重构成了按业务模块独立连接。4.4 中文乱码与字符集不一致从 MySQL 5.7 读出来的中文是问号或“??”通常不是 Delphi 的问题而是连接字符集和服务器、表字符集不一致。排查思路是先通过命令行客户端执行SELECT character_set_server, character_set_database;看服务器端设置再看表结构SHOW TABLE STATUS LIKE 你的表名;。如果服务器和表都是 utf8那就是连接层没设置字符集。此时在连接参数里把 CharacterSet 配上或者在 Open 后执行SET NAMES utf8mb4一般能解决。需要提醒一旦用了 utf8mb4客户端库版本太老可能不支持连接时直接报字符集无法识别这时把 libmysql.dll 换成 5.7 以上版本就好。4.5 64 位程序怎么办准备切换 FireDAC如果你用新 Delphi 做 64 位程序别在 dbExpress 上硬磕了。老版本 dbxopenmysql50.dll 的 64 位支持很差新版本虽然能编译成 64 位但配套的 libmysql.dll、依赖链和部署又会带来新坑。FireDAC 是更好的选择代码量也没有多多少var FDConn: TFDConnection; begin FDConn : TFDConnection.Create(nil); try FDConn.DriverName : MySQL; FDConn.Params.Database : testdb; FDConn.Params.UserName : root; FDConn.Params.Password : 123456; FDConn.Params.Add(ServerCharSetutf8mb4); FDConn.Open; finally FDConn.Free; end; end;FireDAC 的 MySQL 驱动在内部也会调用 libmysql.dll但它处理了更多细节比如 64 位支持、字符集映射、连接池等。如果你维护的是老库又必须在 64 位下运行我建议尽早规划迁移别等项目上线前夜才换驱动。5. 经验随笔几句大实话5.1 关于那个 zip 压缩包多说一句安全提醒很多人会搜到一个名为 “dbexpress连接mysql5.7需要的libmysql和dbxopenmysql50动态库.zip” 之类的压缩包直接解压就往程序里丢。这种收集常见运行库的做法方便但风险在于你不知道压缩包是谁打的DLL 签名是否完整里面有没有被塞进奇怪的东西。我见过有人从网盘下载的 dbxopenmysql50.dll 被安全软件查到捆绑行为。最稳妥的办法是按上面第 2 节的方式从自己 Delphi 安装目录和 MySQL 官方包里分别提取顺便用sigcheck或文件属性里的数字签名看一眼。花十分钟做这件事比事后给客户解释中毒事件强太多。5.2 如果被 DLL 问题卡住我的排查顺序最后分享一个我自己的排查顺序权当参考先确认进程位数再确认 DLL 是否在 exe 目录再检查 libmysql.dll 版本和依赖运行库最后才去查连接参数。如果这几个都正常连不上时去看 MySQL 的 general log看服务器有没有收到握手包。多数时候问题不在代码而在环境。dbExpress 连接 MySQL 5.7 这件事本质上就是 DLL 环境匹配的问题。只要把两个动态库当成一等公民对待合理放在部署路径下老 Delphi 一样能稳定跑在 MySQL 5.7 上。本文还有配套的精品资源点击获取