MariaDB在Ubuntu上的升级方法

Ubuntu 上升级 MariaDB 的完整步骤

一 升级前准备

• 备份所有数据库与配置：使用逻辑备份确保可回滚，例如执行全库导出：mysqldump -u root -p --all-databases > /path/to/backup/all-databases.sql；同时备份关键目录与文件（如 /etc/mysql/、数据目录、配置文件）。
• 检查与记录现有版本：mysql -V 或登录后 SELECT VERSION();，便于升级后核对。
• 选择升级策略：跨小版本通常可直接升级；跨多个大版本建议按中间版本逐步升级，降低风险。
• 规划维护窗口与回滚方案：升级期间设置只读或停写，保留旧版本包与数据目录的快照/备份，以便快速回滚。

二 标准升级步骤（同系列小版本或官方仓库升级）

• 更新系统软件包索引：sudo apt update && sudo apt upgrade。
• 安装/更新 MariaDB 服务器与客户端（保持同一版本）：sudo apt install mariadb-server mariadb-client。
• 重启服务：sudo systemctl restart mariadb。
• 执行升级后系统表检查与修复：sudo mariadb-upgrade（MariaDB 10.4+ 提供该工具；旧版本可用 mysql_upgrade）。
• 验证版本：mysql -V 或登录后 SELECT VERSION();。
• 如从旧版系统源升级且遇到认证变化（例如 root 使用 unix_socket 插件），可按需在维护模式重置认证方式后再恢复。

三 跨版本或跨仓库升级（添加官方仓库）

• 导入 MariaDB 签名密钥（如尚未导入）：sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 0xF1656F24C74CD1D8。
• 添加官方 APT 源（将 与 <UBUNTU_CODENAME> 替换为实际值，如 10.11、jammy）：
  • 推荐方式（使用 MariaDB 官方镜像生成器）：访问 MariaDB 下载页生成对应命令；或手动写入源文件：
    deb [arch=amd64,arm64,armhf] https://mirror.yandex.ru/mariadb/repo/<VERSION>/ubuntu <UBUNTU_CODENAME> main。
• 更新索引：sudo apt update。
• 查看可用版本：apt-cache policy mariadb-server，确认目标版本可见。
• 执行安装/升级（两种常用方式，二选一）：
  • 直接安装（保持同一版本族的最新修订）：sudo apt install mariadb-server mariadb-client；
  • 指定版本安装：sudo apt install mariadb-server=<VERSION>* mariadb-client=<VERSION>*。
• 重启服务：sudo systemctl restart mariadb。
• 运行升级后系统表检查：sudo mariadb-upgrade。
• 验证版本：mysql -V 或 SELECT VERSION();。
• 可选：运行安全配置向导：sudo mysql_secure_installation。

四 常见问题与回滚

• 无法登录 root（如提示 “Plugin ‘unix_socket’ is not loaded”）：在维护模式重置 root 认证方式，例如将 plugin 改为 mysql_native_password 并设置密码，然后重启服务。
• 升级失败或异常：使用之前的备份与快照回滚；必要时卸载并重装旧版本，再导入备份数据。
• 大版本跨跃风险：优先采用逐步升级路径（例如先到中间版本，再到目标版本），并在每一步执行 mariadb-upgrade 校验系统表。
• 配置不兼容：逐项比对新旧版本的 my.cnf 差异，逐步启用新特性，避免一次性变更导致服务异常。