Linux环境下MariaDB版本升级指南

一、升级前的准备工作

1. 备份所有重要数据

升级前必须备份数据库，防止操作失误导致数据丢失。推荐使用mysqldump工具导出所有数据库：

mysqldump -u root -p --all-databases >
     full_backup.sql

输入密码后，备份文件将保存在当前目录（建议转移至安全路径）。

2. 检查当前MariaDB版本

确认当前安装的版本，明确升级方向（如从10.3升级到10.6）：

mysql -u root -p -e "SELECT VERSION();
    "

或通过命令行直接查看：

mysql -V

输出示例：mysql Ver 15.1 Distrib 10.3.48-MariaDB, for debian-linux-gnu (x86_64) using readline 5.2。

二、常见升级方式（分包管理器）

1. 使用APT包管理器（适用于Ubuntu/Debian）

（1）通过官方仓库升级（推荐）

若需升级到最新稳定版，建议添加MariaDB官方APT仓库，确保获取最新版本：

# 移除旧版本（可选，避免残留配置冲突）
sudo apt remove --purge mariadb-server mariadb-client

# 下载并添加MariaDB官方仓库（以10.5为例，需替换为目标版本）
wget https://downloads.mariadb.com/MariaDB/mariadb_repo_setup
sudo apt install ./mariadb_repo_setup
sudo bash mariadb_repo_setup --mariadb-server-version "mariadb-10.5"

# 更新包列表并安装
sudo apt update
sudo apt install mariadb-server mariadb-client

安装过程中，系统会自动处理依赖关系。

（2）直接升级现有版本

若已通过APT安装MariaDB，可直接升级：

sudo apt update
sudo apt upgrade mariadb-server

升级完成后，需执行安全配置脚本优化设置：

sudo mysql_secure_installation

2. 使用YUM/DNF包管理器（适用于CentOS/RHEL）

（1）通过官方仓库升级

# 移除旧版本（可选）
sudo yum remove mariadb-server mariadb

# 下载并添加MariaDB官方YUM仓库（以10.6为例）
wget https://downloads.mariadb.com/MariaDB/mariadb_repo_setup
sudo yum install ./mariadb_repo_setup
sudo bash mariadb_repo_setup --mariadb-server-version "mariadb-10.6"

# 更新包列表并安装
sudo yum update
sudo yum install mariadb-server

（2）直接升级现有版本

sudo yum update mariadb-server

升级后重启服务：

sudo systemctl restart mariadb

3. 离线升级（无网络环境）

若无法连接互联网，需下载指定版本的安装包手动升级：

（1）下载对应版本的安装包

以Debian为例，下载MariaDB 11.5.2的Debian包：

wget https://dlm.mariadb.com/3895090/MariaDB/mariadb-11.5.2/repo/debian/mariadb-11.5.2-debian-bookworm-amd64-debs.tar

（2）解压并设置仓库

tar -xvf mariadb-11.5.2-debian-bookworm-amd64-debs.tar
cd mariadb-11.5.2-debian-bookworm-amd64-debs/
./setup_repository

（若提示mariadb.list已存在，可重命名后重新运行）

（3）安装升级

sudo apt update
sudo apt install mariadb-server

升级后需处理配置文件冲突（如50-server.cnf），建议先查看差异再选择保留本地配置或覆盖。

三、升级后的关键操作

1. 运行升级脚本

部分情况下，需手动运行mysql_upgrade脚本修复表结构兼容性问题：

sudo /usr/bin/mysql_upgrade -u root -p

输入密码后，脚本会自动检查并升级所有数据库表。

2. 重启MariaDB服务

确保所有升级变更生效：

sudo systemctl restart mariadb

3. 验证升级结果

登录MariaDB并检查版本：

mysql -u root -p

在命令行中执行：

SELECT VERSION();
    

输出应显示目标版本（如10.6.5-MariaDB），确认升级成功。

四、注意事项

1. 兼容性检查

升级前查阅MariaDB官方升级指南（如从10.3升级到10.5），确保应用程序、插件及自定义脚本与新版本兼容。

2. 测试环境验证

生产环境升级前，务必在测试环境中模拟升级流程，排查潜在问题（如配置文件冲突、表结构不兼容）。

3. 配置文件处理

升级过程中，若系统提示配置文件冲突（如/etc/mysql/mariadb.conf.d/50-server.cnf），建议先使用diff命令查看差异，保留本地自定义配置（如端口、字符集），避免覆盖重要设置。

4. 日志监控

升级过程中密切关注MariaDB日志（通常位于/var/log/mysql/或/var/log/mariadb/），及时发现并解决错误（如表损坏、权限问题）。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！