Ubuntu MariaDB版本兼容性问题

Ubuntu 上 MariaDB 版本兼容性与升级要点

一 版本矩阵与系统源差异

• 不同 Ubuntu LTS 自带的 MariaDB 主版本不同，跨版本升级或混装第三方源容易引发兼容性问题。下表给出常见 LTS 的默认版本与建议路径（仅作参考，具体以实际仓库为准）：

• 说明：
  • 例如 Ubuntu 18.04 官方源通常仅到 10.1；如需 10.4，需添加 MariaDB 官方仓库后安装或升级。
  • Ubuntu 16.04 系统源中的 10.0 已结束支持，生产环境应升级或迁移。

二 常见兼容性问题与症状

• 升级后 root 无法登录，报错：ERROR 1524 (HY000): Plugin ‘unix_socket’ is not loaded
  原因：高版本 MariaDB 默认使用 unix_socket 认证，某些场景下插件未加载或权限配置不当。
  处理：在维护模式重置 root 认证方式（示例将 root 改为密码认证）：

  • 停止服务：sudo systemctl stop mariadb
  • 无密码登录：sudo mysqld_safe --skip-grant-tables &
  • 执行 SQL：
    • USE mysql;
    • ALTER USER 'root'@'localhost' IDENTIFIED VIA mysql_native_password USING PASSWORD('YourNewPass');
    • FLUSH PRIVILEGES;
  • 重启：sudo systemctl restart mariadb
    注：若希望保留 unix_socket 免密本地登录，可改为 IDENTIFIED VIA unix_socket 并确保插件可用。

• 升级后 服务无法启动，journal 提示插件或权限问题
  现象：systemctl status mariadb 显示失败，journalctl -xeu mariadb 可见如 GSSAPI 插件默认主体不匹配、或 InnoDB 数据文件异常等。
  处理思路：

  • 检查日志定位具体插件/权限/数据问题；
  • 若涉及 GSSAPI，确认是否需要该插件，不需要可在配置中禁用；
  • 若怀疑数据损坏或与新版本不兼容，优先从备份恢复（见下节）。

• 从 MySQL 迁移到 MariaDB 的兼容性边界

  • 建议的迁移路径：MySQL 5.6 → MariaDB 10.0+，MySQL 5.7 → MariaDB 10.2+，MySQL 8.0+ → 使用 mysqldump 导出再导入。
  • 认证插件差异：MySQL 5.7/8.0 默认使用 caching_sha2_password，而 MariaDB 常用 unix_socket 或 mysql_native_password；迁移后需统一认证方式。
  • 系统库/依赖差异：两者虽接口相近，但库文件与系统配置并非 100% 兼容，跨产品迁移务必全量逻辑备份与回归测试。

三 安全升级与回滚流程

• 升级前

  • 全量逻辑备份：mysqldump -A --single-transaction --routines --triggers --hex-blob --set-gtid-purged=OFF > backup.sql
  • 记录现有配置与版本：mysql --version、mariadb --version、sudo systemctl status mariadb、cat /etc/os-release
  • 选择升级路径：优先使用 官方仓库的小版本升级，避免跨多主版本跳跃；必要时分阶段升级（如 10.1 → 10.2 → 10.3）。

• 升级中

  • 添加 MariaDB 官方仓库（示例）：
    • 安装工具：sudo apt-get install -y software-properties-common apt-transport-https ca-certificates
    • 导入密钥：sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 0xF1656F24C74CD1D8
    • 添加源（以 Ubuntu 18.04 + MariaDB 10.4 为例）：
      sudo add-apt-repository 'deb [arch=amd64,arm64,ppc64el] https://mirrors.evowise.com/mariadb/repo/10.4/ubuntu bionic main'
    • 执行升级：sudo apt-get update && sudo apt-get install mariadb-server mariadb-client
  • 升级后执行：sudo mysql_upgrade -u root -p（必要时加 --force）以完成系统表与权限结构升级。

• 升级后

  • 运行安全加固：sudo mysql_secure_installation
  • 回归测试：连接验证、主从复制/应用连接、存储过程/触发器、InnoDB 特性、字符集与排序规则、备份恢复演练。

• 回滚

  • 使用升级前的全量备份进行恢复；若采用分阶段升级，优先回退到上一阶段稳定版本并复核数据一致性。

四 运维与配置建议

• 明确目标版本：优先使用 Ubuntu 官方 LTS 源或 MariaDB 官方仓库的受支持版本，避免混装多个仓库导致依赖冲突。
• 谨慎启用可选插件：如 GSSAPI、审计、压缩等插件需确认依赖与必要性，避免启动失败或性能回退。
• 统一认证策略：跨版本/跨产品迁移后，统一 root 与应用账户的认证插件与密码策略，避免 “unix_socket 与密码” 混用导致的连接问题。
• 持续监控与演练：升级后在预发环境进行流量回放与备份恢复演练，确保兼容性与可回滚性。