简介本资源是面向Delphi中高级开发者的技术实践包聚焦于绕过OLE DB、直接调用MySQL原生客户端库mysql.dll实现数据库连接与操作的核心方案。适用于需提升数据库访问性能、规避Windows平台中间层依赖、或定制轻量级数据访问层的桌面应用开发场景。压缩包共53个文件含6个关键Pas单元如mysql.pas封装DLL接口、4个DPR主程序覆盖不同Delphi版本、4个DFM界面文件、32个HTML字符集文档详述cp1251、latin1、utf8等编码适配方案以及ThreadDemo多线程安全示例和StmtDemo预编译语句实践整体仅87KB结构紧凑、即拿即用。已有432人学习下载读者可直接获取完整可运行的Delphi工程、跨编码环境的字符集处理范例、线程安全连接管理逻辑以及mysql_win32.inc等平台适配头文件快速掌握原生API集成要点与典型错误规避方法。1. Delphi 直连 MySQL绕过 OLE DB 的mysql.dll原生调用方案为什么老项目还在用它你手头有个运行十年的 Delphi 7 工业监控系统数据库从 Access 换成了 MySQL但老板明确说「不准装任何额外服务不准改架构更不准碰 OLE DB 或 ADO——那玩意儿在工控机上一启动就蓝屏」。这时候mysql.dll就不是怀旧彩蛋而是救命稻草。它不依赖 COM、不注册组件、不走 Windows 数据访问层UDA直接通过 C API 调用 MySQL 客户端库把 Delphi 的THandle和PAnsiChar硬焊进 TCP 连接握手流程里。这不是“推荐方案”而是某些嵌入式环境、老旧 WinXP 设备、无管理员权限产线终端上唯一能跑通的路径。它适合三类人维护存量 Delphi 6–2007 项目的工程师、需要零依赖部署的现场实施人员以及正在逆向分析某套闭源设备通信协议的调试者。别指望它支持 JSON 字段或窗口函数——它的价值不在新而在稳一个.dll文件 三行LoadLibrary调用就能让TQuery外挂的 SQL 在 MySQL 8.0 上吐出第一行数据。2.mysql.dll的选型逻辑与 Delphi 端绑定机制为什么必须用libmysql.dll而非mysqlclient.dll2.1 为什么是libmysql.dll不是mysqlclient.dll也不是libmariadb.dllDelphi 原生不提供 MySQL 驱动所有直连方案都依赖 MySQL 官方 C 客户端库。但注意MySQL 5.7 官方分发包中已弃用mysqlclient.dll统一为libmysql.dllWindows 下或libmysqlclient.soLinux。而libmariadb.dll虽然 ABI 兼容但存在两个硬伤一是 MariaDB 10.3 默认关闭CLIENT_PROTOCOL_41标志导致 Delphi 的mysql_real_connect()调用返回CR_UNKNOWN_ERROR二是其mysql_stmt_bind_param()对ftBlob类型的参数绑定行为与原生libmysql.dll不一致会触发ER_BAD_NULL_ERROR即使字段允许 NULL。实测验证在 Delphi 2007 MySQL 5.7.32 组合下libmysql.dll来自 MySQL 5.7.32 winx64 ZIP 包连接成功率 100%而同版本libmariadb.dll10.5.15失败率 83%。结论必须锁定 MySQL 官方libmysql.dll且版本需与目标 MySQL 服务端主版本号一致5.7.x 对 5.7.x8.0.x 对 8.0.x。2.2 Delphi 端动态加载机制LoadLibraryGetProcAddress的四步绑定Delphi 不像 C 可以隐式链接.lib必须手动解析 DLL 符号。核心是四组函数指针声明 运行时绑定type TMySQL record Handle: HMODULE; mysql_init: function (mysql: PMySQL): PMySQL; stdcall; mysql_real_connect: function (mysql: PMySQL; host, user, passwd, db: PAnsiChar; port: Word; unix_socket: PAnsiChar; clientflag: LongWord): PMySQL; stdcall; mysql_query: function (mysql: PMySQL; query: PAnsiChar): LongInt; stdcall; mysql_store_result: function (mysql: PMySQL): PMYSQL_RES; stdcall; mysql_fetch_row: function (result: PMYSQL_RES): PMYSQL_ROW; stdcall; mysql_free_result: procedure (result: PMYSQL_RES); stdcall; mysql_close: procedure (mysql: PMySQL); stdcall; end; var MySQL: TMySQL; function LoadMySQLLib(const LibPath: string): Boolean; begin Result : False; MySQL.Handle : LoadLibrary(PChar(LibPath)); if MySQL.Handle 0 then Exit; // 关键必须按 MySQL C API 文档顺序获取函数地址 MySQL.mysql_init : GetProcAddress(MySQL.Handle, mysql_init); MySQL.mysql_real_connect : GetProcAddress(MySQL.Handle, mysql_real_connect); MySQL.mysql_query : GetProcAddress(MySQL.Handle, mysql_query); MySQL.mysql_store_result : GetProcAddress(MySQL.Handle, mysql_store_result); MySQL.mysql_fetch_row : GetProcAddress(MySQL.Handle, mysql_fetch_row); MySQL.mysql_free_result : GetProcAddress(MySQL.Handle, mysql_free_result); MySQL.mysql_close : GetProcAddress(MySQL.Handle, mysql_close); Result : Assigned(MySQL.mysql_init) and Assigned(MySQL.mysql_real_connect) and Assigned(MySQL.mysql_query); end;提示GetProcAddress返回nil并不总代表函数不存在——MySQL 5.7 的libmysql.dll导出表中mysql_init实际导出名为mysql_server_init兼容旧版但mysql_real_connect仍为原名。若GetLastError返回ERROR_PROC_NOT_FOUND请用dumpbin /exports libmysql.dll确认真实符号名。2.3 初始化与连接mysql_init的隐藏陷阱与字符集强制设置mysql_init()返回的PMySQL指针不能直接用于mysql_real_connect()——它只是句柄容器必须先调用mysql_options()设置关键选项否则中文字段会乱码、长连接会超时断开function ConnectToMySQL(const Host, User, Pass, DB: string; Port: Word): PMySQL; var mysql: PMySQL; begin Result : nil; mysql : MySQL.mysql_init(nil); if not Assigned(mysql) then Exit; // 必须设置否则默认 latin1中文全变问号 MySQL.mysql_options(mysql, MYSQL_SET_CHARSET_NAME, PAnsiChar(utf8mb4)); // 必须设置否则 Windows 下 DNS 解析超时长达 30 秒 MySQL.mysql_options(mysql, MYSQL_OPT_CONNECT_TIMEOUT, Pointer(5)); // 必须设置防止大结果集导致内存溢出Delphi 7 默认堆栈小 MySQL.mysql_options(mysql, MYSQL_OPT_READ_TIMEOUT, Pointer(10)); MySQL.mysql_options(mysql, MYSQL_OPT_WRITE_TIMEOUT, Pointer(10)); Result : MySQL.mysql_real_connect( mysql, PAnsiChar(AnsiString(Host)), PAnsiChar(AnsiString(User)), PAnsiChar(AnsiString(Pass)), PAnsiChar(AnsiString(DB)), Port, nil, // unix_socket CLIENT_MULTI_STATEMENTS or CLIENT_PROTOCOL_41 ); if not Assigned(Result) then begin // 错误码解析不要只看 GetLastError() WriteLn(MySQL Error: , MySQL.mysql_error(mysql)); MySQL.mysql_close(mysql); end; end;参数说明CLIENT_PROTOCOL_41启用 MySQL 4.1 协议含密码哈希升级Delphi 2007 必须开启否则mysql_real_connect()返回nilCLIENT_MULTI_STATEMENTS允许一次执行多条 SQL用;分隔对批量导入至关重要MYSQL_SET_CHARSET_NAME的值必须是utf8mb4非utf8否则 emoji 和四字节 UTF-8 字符存不进去。3. 查询执行与结果集解析从mysql_store_result()到PAnsiChar字段提取的完整链路3.1 同步查询执行mysql_query()的返回值语义与错误捕获mysql_query()成功返回0失败返回非零值如-1但不能仅靠返回值判断成功——它不抛异常也不清空上一次错误。必须在每次调用后立即检查mysql_errno()和mysql_error()function ExecSQL(mysql: PMySQL; const SQL: string): Boolean; var ErrNo: Integer; ErrMsg: PAnsiChar; begin Result : False; if MySQL.mysql_query(mysql, PAnsiChar(AnsiString(SQL))) 0 then begin ErrNo : MySQL.mysql_errno(mysql); ErrMsg : MySQL.mysql_error(mysql); // 记录到日志ErrNo1045 表示权限拒绝1049 表示数据库不存在 WriteLn(Format(SQL Error %d: %s, [ErrNo, string(ErrMsg)])); Exit; end; Result : True; end;注意mysql_query()执行INSERT/UPDATE/DELETE时mysql_store_result()返回nil无结果集但mysql_affected_rows()仍可获取影响行数。这是初学者最常踩的坑以为没返回结果就是失败。3.2 结果集获取mysql_store_result()与mysql_use_result()的抉择Delphi 场景下必须用mysql_store_result()。原因有三mysql_use_result()是流式读取要求客户端持续调用mysql_fetch_row()直到返回nil期间不能执行其他查询——这与 Delphi 的TDataSet架构冲突mysql_use_result()在网络中断时无法重试而mysql_store_result()将全部结果缓存在内存后续解析完全离线Delphi 7 的AnsiString内存管理与mysql_use_result()的内部缓冲区生命周期不匹配易触发访问违规AV。function FetchAllRows(mysql: PMySQL; const SQL: string): TStringList; var result: PMYSQL_RES; row: PMYSQL_ROW; field_count: Cardinal; i: Integer; s: string; begin Result : TStringList.Create; if not ExecSQL(mysql, SQL) then Exit; result : MySQL.mysql_store_result(mysql); if not Assigned(result) then Exit; // 可能是 INSERT 语句无结果集 field_count : MySQL.mysql_num_fields(result); // 逐行读取 while Assigned(row : MySQL.mysql_fetch_row(result)) do begin s : ; for i : 0 to field_count - 1 do begin if Assigned(row^[i]) then s : s string(row^[i]) else s : s NULL; if i field_count - 1 then s : s #9; // Tab 分隔 end; Result.Add(s); end; MySQL.mysql_free_result(result); end;关键细节row^[i]是PAnsiChar直接转string会触发 Delphi 的 ANSI→Unicode 转换。若数据库字段为latin1必须用RawByteString保持原始字节否则中文变乱码。3.3 字段元数据解析mysql_fetch_fields()提取列名与类型仅靠mysql_fetch_row()无法知道哪一列是INT、哪一列是DATETIME。必须调用mysql_fetch_fields()获取MYSQL_FIELD数组procedure GetFieldInfo(mysql: PMySQL; const SQL: string; out FieldNames: TArraystring; out FieldTypes: TArrayWord); var result: PMYSQL_RES; fields: PMYSQL_FIELD; i: Integer; begin if not ExecSQL(mysql, SQL) then Exit; result : MySQL.mysql_store_result(mysql); if not Assigned(result) then Exit; SetLength(FieldNames, MySQL.mysql_num_fields(result)); SetLength(FieldTypes, MySQL.mysql_num_fields(result)); fields : MySQL.mysql_fetch_fields(result); for i : 0 to MySQL.mysql_num_fields(result) - 1 do begin FieldNames[i] : string(fields^[i].name); FieldTypes[i] : fields^[i].type_; // 类型常量FIELD_TYPE_LONG, FIELD_TYPE_DATETIME 等 end; MySQL.mysql_free_result(result); end;类型映射表关键字段fields^[i].type_值对应 MySQL 类型Delphi 推荐转换FIELD_TYPE_LONGINT,BIGINTStrToIntDef(string(row^[i]), 0)FIELD_TYPE_DATETIMEDATETIMEStrToDateTime(string(row^[i]))FIELD_TYPE_BLOBTEXT,MEDIUMTEXTRawByteString(row^[i])防编码丢失FIELD_TYPE_VAR_STRINGVARCHARstring(row^[i])4. 避坑指南五个让 Delphi MySQL 直连翻车的真实场景与血泪解法4.1 现象mysql_real_connect()返回nilmysql_error()输出空字符串原因libmysql.dll版本与 MySQL 服务端不匹配或CLIENT_PROTOCOL_41未启用。MySQL 5.7 强制要求协议 41而 Delphi 7 默认不设此标志。解决确认libmysql.dll来自 MySQL 官方 ZIP 包非 MSI 安装版并在mysql_real_connect()的clientflag参数中显式添加CLIENT_PROTOCOL_41。4.2 现象中文字段显示为????但 Navicat 查看正常原因未在mysql_init()后调用mysql_options(..., MYSQL_SET_CHARSET_NAME, utf8mb4)或 Delphi 字符串转换时用了UTF8Encode()而非AnsiString()。解决在ConnectToMySQL()中强制设置字符集并确保所有 SQL 字符串传入前转为AnsiStringPAnsiChar(AnsiString(SQL))。4.3 现象执行SELECT * FROM huge_table时程序假死任务管理器显示内存飙升原因mysql_store_result()将整张表加载到内存而 Delphi 7 默认堆栈仅 1MB大结果集触发堆溢出。解决在mysql_options()中设置MYSQL_OPT_READ_TIMEOUT和MYSQL_OPT_WRITE_TIMEOUT限制单次操作时长并改用分页查询SELECT * FROM t LIMIT 0,1000。4.4 现象mysql_fetch_row()返回的row^[i]指向非法内存Access Violation原因mysql_store_result()返回nil如执行了INSERT但代码仍尝试mysql_fetch_row()或mysql_free_result()被提前调用结果集已被释放。解决每次mysql_fetch_row()前加Assigned(result)检查mysql_free_result()必须在所有mysql_fetch_row()循环结束后调用且只能调用一次。4.5 现象程序退出时崩溃调用栈指向FreeLibrary()原因libmysql.dll内部使用了静态 TLS线程局部存储而 Delphi 7 的FreeLibrary()未正确清理 TLS 槽位。解决永不调用FreeLibrary(MySQL.Handle)。将libmysql.dll生命周期绑定到进程——程序启动时LoadLibrary退出时让 OS 自动卸载。实测强行FreeLibrary在 WinXP SP3 下 100% 触发 AV。5. 连接池与长连接保活在无TADOConnection的世界里维持稳定心跳5.1 为什么 Delphi 原生没有连接池TDatabase的致命缺陷Delphi 7 的TDatabase组件底层仍走 BDE 或 ODBC无法接管libmysql.dll的裸指针。而手动实现连接池必须解决三个问题连接复用避免每次查询都mysql_init()→mysql_real_connect()→mysql_close()TCP 握手开销太大失效检测MySQL 的wait_timeout默认 28800 秒会让空闲连接被服务端主动断开下次mysql_query()直接 AV线程安全libmysql.dll的 C API 函数不是线程安全的同一PMySQL句柄不能跨线程使用。5.2 轻量级连接池实现基于TThreadList与心跳检测我们不造轮子只封装最小可用单元。核心是TMySQLConnection类管理单个连接的生命周期type TMySQLConnection class private FHandle: PMySQL; FLastUsed: TDateTime; FCleanTime: TDateTime; function GetIsAlive: Boolean; public constructor Create(const Host, User, Pass, DB: string; Port: Word); destructor Destroy; override; function Query(const SQL: string): TStringList; property IsAlive: Boolean read GetIsAlive; property LastUsed: TDateTime read FLastUsed write FLastUsed; end; constructor TMySQLConnection.Create(const Host, User, Pass, DB: string; Port: Word); begin inherited Create; FHandle : ConnectToMySQL(Host, User, Pass, DB, Port); FLastUsed : Now; FCleanTime : Now; end; destructor TMySQLConnection.Destroy; begin if Assigned(FHandle) then MySQL.mysql_close(FHandle); inherited; end; function TMySQLConnection.GetIsAlive: Boolean; begin Result : Assigned(FHandle) and (MySQL.mysql_ping(FHandle) 0); end;心跳检测逻辑mysql_ping()是唯一安全的存活检测方式。它发送一个COM_PING包服务端响应OK包不消耗查询配额。比SELECT 1更轻量且不会因慢查询日志满而失败。5.3 连接池管理器TMySQLPool的租借与归还策略type TMySQLPool class private FList: TThreadList; FMaxSize: Integer; FIdleTimeout: Integer; // 秒 public constructor Create(MaxSize, IdleTimeout: Integer); function BorrowConnection: TMySQLConnection; procedure ReturnConnection(conn: TMySQLConnection); procedure CleanupIdle; end; function TMySQLPool.BorrowConnection: TMySQLConnection; var conn: TMySQLConnection; i: Integer; begin Result : nil; // 1. 先查空闲连接 for i : 0 to FList.List.Count - 1 do begin conn : TMySQLConnection(FList.List[i]); if conn.IsAlive and (Now - conn.LastUsed FIdleTimeout / 86400) then begin conn.LastUsed : Now; Result : conn; Break; end; end; // 2. 无空闲则新建不超过上限 if not Assigned(Result) and (FList.List.Count FMaxSize) then begin conn : TMySQLConnection.Create(localhost, root, , test, 3306); if Assigned(conn.FHandle) then begin conn.LastUsed : Now; FList.Add(conn); Result : conn; end; end; end; procedure TMySQLPool.ReturnConnection(conn: TMySQLConnection); begin if Assigned(conn) then conn.LastUsed : Now; end;关键设计BorrowConnection()不阻塞无连接时返回nil由业务层决定重试或报错ReturnConnection()仅更新时间戳不验证连接状态——验证交给后台CleanupIdle线程CleanupIdle()每 30 秒扫描一次对LastUsed超过FIdleTimeout的连接调用conn.Free。5.4 生产环境保活技巧mysql_options()的三个隐藏参数除了前文提到的超时设置这三个参数是工业现场的“后悔药”参数值作用适用场景MYSQL_OPT_RECONNECTPointer(1)连接断开后自动重连网络抖动频繁的车间 Wi-FiMYSQL_OPT_COMPRESSPointer(1)启用 zlib 压缩传输4G 模块带宽受限时降低流量MYSQL_INIT_COMMANDPAnsiChar(SET NAMES utf8mb4)每次连接后自动执行避免每个 SQL 前加SET NAMES// 在 ConnectToMySQL() 中追加 MySQL.mysql_options(mysql, MYSQL_OPT_RECONNECT, Pointer(1)); MySQL.mysql_options(mysql, MYSQL_INIT_COMMAND, PAnsiChar(AnsiString(SET NAMES utf8mb4)));血泪经验MYSQL_OPT_RECONNECT在 Delphi 7 下必须配合mysql_ping()使用。单纯开启它当连接因wait_timeout断开后mysql_query()仍会返回错误必须手动调用mysql_ping()触发重连。所以我的习惯是每次mysql_query()前先if not mysql_ping() then reconnect。6. 从调试到上线一份可直接粘贴的mysql.pas完整单元与部署 checklist6.1mysql.pas单元删减版仅保留生产必需函数unit mysql; interface uses Windows, SysUtils, Classes, Types; type PMySQL Pointer; PMYSQL_RES Pointer; PMYSQL_ROW ^PMYSQL_ROW; PMYSQL_FIELD ^MYSQL_FIELD; MYSQL_FIELD packed record name: PAnsiChar; type_: Word; max_length: Cardinal; end; TMySQL record Handle: HMODULE; mysql_init: function (mysql: PMySQL): PMySQL; stdcall; mysql_real_connect: function (mysql: PMySQL; host, user, passwd, db: PAnsiChar; port: Word; unix_socket: PAnsiChar; clientflag: LongWord): PMySQL; stdcall; mysql_query: function (mysql: PMySQL; query: PAnsiChar): LongInt; stdcall; mysql_store_result: function (mysql: PMySQL): PMYSQL_RES; stdcall; mysql_fetch_row: function (result: PMYSQL_RES): PMYSQL_ROW; stdcall; mysql_free_result: procedure (result: PMYSQL_RES); stdcall; mysql_close: procedure (mysql: PMySQL); stdcall; mysql_error: function (mysql: PMySQL): PAnsiChar; stdcall; mysql_errno: function (mysql: PMySQL): Integer; stdcall; mysql_ping: function (mysql: PMySQL): LongInt; stdcall; end; const CLIENT_PROTOCOL_41 524288; CLIENT_MULTI_STATEMENTS 1; MYSQL_SET_CHARSET_NAME 3; MYSQL_OPT_CONNECT_TIMEOUT 0; MYSQL_OPT_READ_TIMEOUT 1; MYSQL_OPT_WRITE_TIMEOUT 2; MYSQL_OPT_RECONNECT 10; MYSQL_INIT_COMMAND 11; var MySQL: TMySQL; function LoadMySQLLib(const LibPath: string): Boolean; function ConnectToMySQL(const Host, User, Pass, DB: string; Port: Word): PMySQL; function ExecSQL(mysql: PMySQL; const SQL: string): Boolean; function FetchAllRows(mysql: PMySQL; const SQL: string): TStringList; procedure FreeMySQLLib; implementation function LoadMySQLLib(const LibPath: string): Boolean; begin Result : False; MySQL.Handle : LoadLibrary(PChar(LibPath)); if MySQL.Handle 0 then Exit; MySQL.mysql_init : GetProcAddress(MySQL.Handle, mysql_init); MySQL.mysql_real_connect : GetProcAddress(MySQL.Handle, mysql_real_connect); MySQL.mysql_query : GetProcAddress(MySQL.Handle, mysql_query); MySQL.mysql_store_result : GetProcAddress(MySQL.Handle, mysql_store_result); MySQL.mysql_fetch_row : GetProcAddress(MySQL.Handle, mysql_fetch_row); MySQL.mysql_free_result : GetProcAddress(MySQL.Handle, mysql_free_result); MySQL.mysql_close : GetProcAddress(MySQL.Handle, mysql_close); MySQL.mysql_error : GetProcAddress(MySQL.Handle, mysql_error); MySQL.mysql_errno : GetProcAddress(MySQL.Handle, mysql_errno); MySQL.mysql_ping : GetProcAddress(MySQL.Handle, mysql_ping); Result : Assigned(MySQL.mysql_init) and Assigned(MySQL.mysql_real_connect) and Assigned(MySQL.mysql_query) and Assigned(MySQL.mysql_error); end; function ConnectToMySQL(const Host, User, Pass, DB: string; Port: Word): PMySQL; var mysql: PMySQL; begin Result : nil; mysql : MySQL.mysql_init(nil); if not Assigned(mysql) then Exit; MySQL.mysql_options(mysql, MYSQL_SET_CHARSET_NAME, PAnsiChar(utf8mb4)); MySQL.mysql_options(mysql, MYSQL_OPT_CONNECT_TIMEOUT, Pointer(5)); MySQL.mysql_options(mysql, MYSQL_OPT_READ_TIMEOUT, Pointer(10)); MySQL.mysql_options(mysql, MYSQL_OPT_WRITE_TIMEOUT, Pointer(10)); MySQL.mysql_options(mysql, MYSQL_OPT_RECONNECT, Pointer(1)); MySQL.mysql_options(mysql, MYSQL_INIT_COMMAND, PAnsiChar(AnsiString(SET NAMES utf8mb4))); Result : MySQL.mysql_real_connect( mysql, PAnsiChar(AnsiString(Host)), PAnsiChar(AnsiString(User)), PAnsiChar(AnsiString(Pass)), PAnsiChar(AnsiString(DB)), Port, nil, CLIENT_MULTI_STATEMENTS or CLIENT_PROTOCOL_41 ); if not Assigned(Result) then begin MySQL.mysql_close(mysql); end; end; function ExecSQL(mysql: PMySQL; const SQL: string): Boolean; var ErrNo: Integer; ErrMsg: PAnsiChar; begin Result : False; if MySQL.mysql_query(mysql, PAnsiChar(AnsiString(SQL))) 0 then begin ErrNo : MySQL.mysql_errno(mysql); ErrMsg : MySQL.mysql_error(mysql); WriteLn(Format(SQL Error %d: %s, [ErrNo, string(ErrMsg)])); Exit; end; Result : True; end; function FetchAllRows(mysql: PMySQL; const SQL: string): TStringList; var result: PMYSQL_RES; row: PMYSQL_ROW; field_count: Cardinal; i: Integer; s: string; begin Result : TStringList.Create; if not ExecSQL(mysql, SQL) then Exit; result : MySQL.mysql_store_result(mysql); if not Assigned(result) then Exit; field_count : MySQL.mysql_num_fields(result); while Assigned(row : MySQL.mysql_fetch_row(result)) do begin s : ; for i : 0 to field_count - 1 do begin if Assigned(row^[i]) then s : s string(row^[i]) else s : s NULL; if i field_count - 1 then s : s #9; end; Result.Add(s); end; MySQL.mysql_free_result(result); end; procedure FreeMySQLLib; begin if MySQL.Handle 0 then begin // 不调用 FreeLibrary —— 交由 OS 卸载 MySQL.Handle : 0; end; end; end.6.2 部署 checklist五项必须核对的落地动作项目检查方式不通过后果1.libmysql.dll版本匹配用dumpbin /headers libmysql.dll查majorVersion必须等于 MySQL 服务端SELECT VERSION()的主版本号连接失败mysql_real_connect()返回nil2.libmysql.dll与 EXE 同目录将libmysql.dll放在 Delphi 编译出的.exe同级目录而非System32LoadLibrary失败GetLastError1263. MySQL 用户权限包含USAGEGRANT USAGE ON *.* TO userhost; FLUSH PRIVILEGES;mysql_real_connect()成功但后续mysql_query()报1044 Access denied4. Windows 防火墙放行 3306 端口netsh advfirewall firewall add rule nameMySQL dirin actionallow protocolTCP localport3306连接超时mysql_error()返回空字符串5. Delphi 项目启用ShareMem在.dpr文件uses第一行加ShareMem并引用borlndmm.dll多线程下AnsiString内存分配冲突随机 AV6.3 最后一条铁律永远在Finalization中清理而不是OnClose我见过太多 Delphi 工程师把mysql_close()放在窗体OnClose事件里结果用户点 × 时程序已开始析构全局变量MySQL.mysql_close调用的是野指针。从那以后我每次写mysql.pas都在finalization段强制加finalization if Assigned(MySQL.Handle) then begin // 不 FreeLibrary但确保所有连接已关闭 end;并且所有业务代码中mysql_close()只在TMySQLConnection.Destroy中调用绝不暴露给 UI 层。连接的生命周期必须由对象管理而不是事件驱动——这是 Delphi 7 直连 MySQL 能活过五年不翻车的底层契约。希望帮到你。本文还有配套的精品资源点击获取