如何从包含SHA2哈希列的转储文件恢复MariaDB数据库

解决方案 #

1. 先定位问题根因 #

• 执行命令提取报错附近的内容分析：sed -n '700,710p' ~/jump/dump.sql > problem_part.sql，重点查看这段内容中的控制字符、未转义的特殊符号，以及varbinary类型哈希列的插入值格式。
• 该ERROR 2005并非真的需要连接外部主机，本质是转储文件中未做编码的二进制数据包含的换行、控制符被mysql命令行客户端误解析为客户端参数（比如出现-h类的特殊字符段被识别为指定主机的参数），才触发了主机不存在的报错。

2. 可重新导出原库的最优修复方案 #

如果可以访问原Mariadb 10.4实例，重新导出时增加--hex-blob参数，强制将所有二进制、varbinary类型字段转换为纯十六进制字符串格式，完全避免特殊字符问题：

mysqldump -u root -p --hex-blob --default-character-set=latin1 mydb > dump_fixed.sql

导出完成后直接执行导入即可：

mysql -u root -p --default-character-set=latin1 mydb < dump_fixed.sql

该方案不会修改原哈希值，导入后数据完整性100%符合预期。

3. 仅能使用现有转储文件的修复方案 #

如果无法重新导出原库，修改导入命令增加参数规避客户端误解析：

mysql -u root -p --binary-mode --default-character-set=latin1 mydb < ~/jump/dump.sql

--binary-mode参数会禁用mysql客户端的所有元命令解析、转义字符处理，专门用于导入包含二进制数据的转储文件，避免内容被误识别为执行参数。
如果仍存在报错，手动找到对应INSERT语句中哈希列的二进制值，替换为0x开头的十六进制字符串，Mariadb会自动将十六进制内容转换为varbinary类型存入，不会破坏原哈希校验值。

4. 导入后验证 #

导入完成后抽样比对哈希列的值、文本字段的内容，确认和原库数据一致即可。

内容的提问来源于stack exchange，提问作者Michael Barron