简介这份资源面向使用 Delphi尤其是 Delphi 7开发、需要通过 dbExpress 连接 MySQL 5.7 数据库的程序员重点解决网上多数 libmysql.dll 与 dbxopenmysql50.dll 版本不匹配、连接失败的问题。压缩包共 17 个文件约 1.3MB包含两个关键动态库 libmysql.dll、dbxopenmysql50.dll以及可直接运行的示例工程源码dpr、pas、dfm、dcu、exe、测试用 SQL 脚本、可视化配置说明文档 docx 和工程配置文件覆盖从库文件到调用示例的完整链路。作者在自身项目中亲测可用并额外演示了如何判断数据库字段是空值还是空字符串程序可在 Windows XP 与 Windows 10 下运行发布时只需携带 libmysql、dbxopenmysql50 和 midas 三个库即可。目前已有 826 人学习下载适合正在被 Delphi 连接 MySQL 5.7 问题困扰、希望直接拿到可用库文件与参考代码的开发者。1. Delphi 连 MySQL 5.7 的坑为什么你装了驱动还是连不上很多人第一次在 Delphi 里用 dbExpress 连 MySQL 5.7都会经历同一个场景组件面板上拖下TSQLConnectionDriver 选MySQL填好主机、端口、用户名、密码点测试连接弹出来的不是成功提示而是Unable to load libmysql.dll或者DBX Error: Driver could not be properly initialized。明明 MySQL 服务跑得好好的Navicat 也能连偏偏 Delphi 这边就是不行。问题基本都出在两个动态库上libmysql.dll和dbxopenmysql50.dll。前者是 MySQL 官方客户端库后者是 dbExpress 用来对接 MySQL 的驱动桥接层。Delphi 自带的 dbExpress 从 XE 系列开始就不再默认附带 MySQL 驱动需要自己补齐这两个文件而且版本、位数、放置路径三者必须同时对错一个就连不上。这套环境在维护老项目、做内部管理系统的团队里非常常见尤其是还在用 Delphi 7 到 XE10 这段版本、数据库又锁死在 MySQL 5.7 的场景。装不好不会报编译错误只会在运行时给你一个模糊的初始化失败排查起来相当费时间。下面按我实际部署的顺序把版本选择、文件放置、参数配置和验证方法一步步写清楚。2. 环境准备版本、位数和文件清单先对齐2.1 确认 Delphi 版本与 dbExpress 驱动支持情况不同 Delphi 版本对 MySQL 驱动的支持差异很大先确认自己处在哪一档再决定用哪个驱动文件。Delphi 版本默认 MySQL 驱动需要的驱动文件备注Delphi 7dbExpress 自带 dbxopenmysql50dbxopenmysql50.dll libmysql.dll老项目最常见组合Delphi 2007~2010部分版本自带dbxopenmysql50.dll libmysql.dll需确认是否被裁剪Delphi XE~XE10不再默认附带dbxopenmysql50.dll libmysql.dll必须手动补齐Delphi 10.2 以上改用 FireDAC 为主仍可用 dbExpress 但驱动难找建议评估迁移我一般会先打开 Delphi在组件面板找dbexpress页签看有没有TSQLConnection。如果有说明 dbExpress 框架在缺的只是 MySQL 驱动层。这一步不用写代码纯靠 IDE 确认能省掉后面很多无效尝试。2.2 位数匹配32 位和 64 位不能混这是最容易翻车的地方。libmysql.dll和dbxopenmysql50.dll的位数必须和你的 Delphi 编译目标一致也要和 MySQL 客户端库的位数一致。Delphi 7 到 XE8 默认编译 32 位程序必须用 32 位的libmysql.dll。Delphi XE2 以上如果编译 64 位目标就要用 64 位版本。两个 dll 的位数必须相同不能一个 32 位一个 64 位。常见做法是先看自己编译出来的 exe 是 32 位还是 64 位然后去找对应位数的libmysql.dll。MySQL 5.7 的安装目录里通常自带lib和lib64两个文件夹分别对应 32 位和 64 位直接取对应目录下的文件即可。2.3 文件清单与来源说明这套环境需要两个文件缺一不可libmysql.dllMySQL 官方客户端动态库负责实际的网络通信和协议解析。MySQL 5.7 安装目录下lib\或lib64\里就有也可以从 MySQL 官方 Connector/C 包里取。dbxopenmysql50.dlldbExpress 的 MySQL 驱动桥接层负责把 dbExpress 的调用翻译成libmysql.dll能理解的接口。这个文件不在 MySQL 安装包里需要单独获取。提示两个文件的版本要互相兼容。dbxopenmysql50.dll对应的是 MySQL 5.x 协议配 MySQL 5.7 没问题但不要拿去连 MySQL 8.0协议和认证方式都变了会直接报认证失败。3. 安装部署两个 dll 到底该放哪3.1 放置路径的优先级规则Windows 加载 dll 有一套固定顺序搞懂这个顺序就不会到处乱放文件。对于 Delphi 程序实际生效的顺序大致是应用程序所在目录exe 同目录当前工作目录系统目录C:\Windows\System32或SysWOW64Windows 目录PATH 环境变量里的目录我一般会把两个 dll 直接放到 exe 同目录这是最稳的做法不依赖系统环境换机器也不会因为 PATH 不同而失效。开发阶段 exe 在Win32\Debug\下就把 dll 放那里发布时跟 exe 一起打包。# 假设项目编译输出目录是 Win32\Debug # 把两个 dll 复制到 exe 同目录 copy libmysql.dll Win32\Debug\ copy dbxopenmysql50.dll Win32\Debug\ # 如果是 64 位目标 copy lib64\libmysql.dll Win64\Debug\ copy dbxopenmysql50.dll Win64\Debug\上面命令里lib64\libmysql.dll是 MySQL 安装目录下的 64 位版本dbxopenmysql50.dll要确认拿的是 64 位版本。复制完不需要注册dbExpress 是运行时动态加载不涉及regsvr32。3.2 在 IDE 里配置驱动和连接参数文件放好后回到 Delphi IDE 配置连接。以TSQLConnection为例object SQLConnection1: TSQLConnection ConnectionName MySQLConnection DriverName MySQL GetDriverFunc getSQLDriverMYSQL LibraryName dbxopenmysql50.dll LoginPrompt False Params.Strings ( HostName127.0.0.1 Databasetestdb User_Nameroot Passwordyourpassword Port3306 BlobSize-1 ErrorResourceFile LocaleCode0000 CompressedFalse EncryptedFalse) Left 100 Top 100 end关键参数说明LibraryName必须写dbxopenmysql50.dll这是驱动桥接层不是libmysql.dll。写错了会报找不到驱动。GetDriverFunc固定为getSQLDriverMYSQL这是 dbExpress 约定的入口函数名。HostNameMySQL 服务器地址本机就写127.0.0.1不要写localhost某些版本下localhost会走命名管道导致连接失败。PortMySQL 5.7 默认 3306如果改过要对应。Compressed和EncryptedMySQL 5.7 下一般保持False开了反而容易出兼容问题。3.3 连接测试与首次运行配置完不要急着写业务代码先做一次最小验证。在窗体上放一个TSQLConnection设置Connected : True或者右键组件选Test Connection。procedure TForm1.Button1Click(Sender: TObject); begin try SQLConnection1.Connected : True; ShowMessage(连接成功); except on E: Exception do ShowMessage(连接失败: E.Message); end; end;这段代码只做一件事尝试建立连接并捕获异常。如果成功说明两个 dll 加载正常、参数正确。如果失败异常信息里通常会带具体原因比如Unable to load libmysql.dll说明文件没找到或位数不对Access denied说明账号密码或权限有问题。先把这个最小用例跑通再往下做查询和数据集。4. 避坑排查五条血泪经验4.1 现象报 Unable to load libmysql.dll但文件明明在原因最常见的是位数不匹配。32 位程序加载 64 位 dll 会直接失败而且报错信息不会告诉你是位数问题。其次是文件放错目录程序实际运行目录和你以为的不一样。解决用 Dependency Walker 或dumpbin /headers确认 exe 和 dll 的位数。把 dll 放到 exe 同目录用 Process Monitor 过滤libmysql.dll看程序到底去哪个路径找。4.2 现象驱动初始化失败报 DBX Error原因dbxopenmysql50.dll缺失或版本不对也可能是LibraryName写成了libmysql.dll。解决确认LibraryName指向dbxopenmysql50.dll确认文件在 exe 同目录确认位数一致。如果还不行换一个来源的dbxopenmysql50.dll再试。4.3 现象连接 MySQL 8.0 报认证插件错误原因MySQL 8.0 默认用caching_sha2_password而dbxopenmysql50.dll只支持mysql_native_password。解决这套驱动就是给 MySQL 5.7 用的不要硬连 8.0。如果必须连 8.0要么改用户认证插件要么换 FireDAC。我一般直接建议项目锁 5.7省事。4.4 现象本机 Navicat 能连Delphi 连不上原因Navicat 自带客户端库不依赖系统里的libmysql.dll。Delphi 用的是你放的那个文件两者不是一回事。解决以 Delphi 这边的报错为准单独排查 dll 和参数不要拿 Navicat 能连当依据。4.5 现象开发机正常部署到客户机就失败原因客户机没装 MySQL 客户端或者系统目录里有旧版本的libmysql.dll被优先加载。解决发布时把两个 dll 跟 exe 放同一目录利用应用程序目录优先级最高的规则避免被系统目录里的旧文件干扰。打包时把 dll 一起带上不要指望客户机自己装。5. 验证跑通一套可复用的自检流程装完之后怎么确认真的没问题我一般走一套固定流程不靠感觉。第一步确认文件就位。在 exe 同目录执行dir libmysql.dll dbxopenmysql50.dll两个文件都要在大小不为零。32 位libmysql.dll通常在 4MB 左右64 位更大一些如果只有几十 KB 那多半是错的。第二步确认位数一致。用dumpbin看 exe 和 dll 的机器类型dumpbin /headers YourApp.exe | findstr machine dumpbin /headers libmysql.dll | findstr machine两行输出的 machine 类型要一致都是 x86 或都是 x64。这一步能提前拦掉大部分玄学问题。第三步跑最小连接用例。就是前面那段Connected : True的代码确认能弹出「连接成功」。第四步跑一次真实查询确认数据集能打开procedure TForm1.Button2Click(Sender: TObject); begin SQLQuery1.Close; SQLQuery1.SQL.Text : SELECT id, name FROM users LIMIT 10; SQLQuery1.Open; ShowMessage(记录数: IntToStr(SQLQuery1.RecordCount)); end;能打开数据集并拿到记录数说明驱动层、协议层、权限层全部打通。第五步换一台干净的机器再跑一遍。这一步最容易被跳过但恰恰最能暴露部署问题。把 exe 和两个 dll 拷到没装过 MySQL 客户端的机器上直接运行能连上才算真正部署成功。注意验证时不要只在一台开发机上测。开发机往往装了一堆东西PATH 里什么都有很多问题被掩盖了。干净机器才是真实环境。从那以后我每次配这套环境都强制走一遍「文件就位 → 位数核对 → 最小连接 → 真实查询 → 干净机器复测」这五步不再凭经验拍脑袋。希望帮到你。本文还有配套的精品资源点击获取