当MySQL 8.4遇上Metabase：一场意料之外的兼容性危机
对于使用1Panel或宝塔面板的开发者而言，MySQL 8.4 LTS与Metabase 0.53.6的组合可能暗藏致命陷阱——数据库连接突然失效，而日志却毫无线索。本文将揭示这一问题的完整排查过程与终极解决方案。
问题现象：诡异的数据库连接失败
故障场景
- Metabase报错：配置MySQL 8.4.4后，Metabase持续提示\”无法连接到数据库\”，API Health检查失败。
- DBeaver异常：客户端工具报错
Public Key Retrieval is not allowed，但通过Adminer直接登录正常。 - 环境共性：
- 宿主机：Proxmox VE 8.3.1 LXC容器
- 操作系统：Debian 12 / Ubuntu 24.04
- 面板类型：1Panel或宝塔面板安装的MySQL 8.4 LTS
初步怀疑方向
- 面板配置错误？——重装1Panel无效
- 操作系统兼容性？——切换Ubuntu 24.04仍失败
- 数据库版本问题？——连接MySQL 8.0.0成功
深度排查：锁定MySQL 8.4 LTS的兼容性缺陷
复现实验
- 跨环境验证：
- 在另一台主机通过宝塔安装MySQL 8.4 LTS
- 使用相同Metabase配置连接，问题复现
- 版本对比测试：
- MySQL 8.0.41：连接正常
- MySQL 8.4.4：100%触发连接失败
关键错误分析
- 公钥检索限制：MySQL 8.4默认禁用
allowPublicKeyRetrieval=true，导致SSL握手失败。 - 协议变更：8.4版本对身份验证插件（如
caching_sha2_password）的强化引发客户端兼容问题。
终极解决方案：降级MySQL至8.0.4
1Panel环境操作指南
# 停止当前MySQL服务
1panel stop mysql
# 卸载MySQL 8.4.4
1panel uninstall mysql
# 安装指定旧版本
1panel install mysql --version=8.0.41
# 重启服务并验证
1panel start mysql
mysql -V # 确认版本号为8.0.41
宝塔面板降级步骤
- 进入【软件商店】→ 搜索MySQL
- 选择【历史版本】→ 切换至8.0.41
- 点击【安装】并等待自动完成
- 在Metabase配置中更新端口和权限：
ALTER USER 'metabase'@'%' IDENTIFIED WITH mysql_native_password BY 'your_password';
FLUSH PRIVILEGES;
根本原因与预防建议
MySQL 8.4的兼容性陷阱
- 认证协议升级：默认启用
caching_sha2_password，旧版客户端（如Metabase 0.53.6）无法适配。 - SSL强化策略：强制要求安全连接参数，未显式配置时触发
Public Key Retrieval错误。
长期规避方案
- 客户端升级：推动Metabase升级至最新版（需验证兼容性）
- 参数调优：在连接字符串中添加：
allowPublicKeyRetrieval=true&useSSL=false
- 版本冻结：生产环境优先使用LTS稳定版本（如8.0.x系列）
延伸讨论：其他面板用户的应对策略
- Docker部署场景：指定镜像标签
mysql:8.0.41以避免自动升级 - 云数据库注意事项：AWS RDS/AliCloud需在控制台手动回滚版本
- 监控建议：安装后立即运行：
echo 'SELECT @@version;' | mysql -u root -p
总结与互动
通过降级MySQL至8.0.41版本，可彻底解决与Metabase的兼容性问题。建议开发者在升级数据库前，务必在测试环境验证关键依赖组件的兼容性。
你是否遇到过类似问题？ 欢迎在评论区分享你的踩坑经历，或访问MySQL官方文档获取更多版本更新细节。
