Debian 上 MariaDB 的兼容性与常见问题处理
一 兼容性与版本选择
- 在 Debian 中，仓库里的 mysql-server 包通常并不存在，系统默认提供的是 MariaDB。安装时可直接使用包名 mariadb-server，或使用虚拟包 default-mysql-server（实际安装的仍是 MariaDB），两者对应用与驱动基本兼容，命令与 SQL 语法与 MySQL 保持一致。若需特定大版本（如 10.6），可添加 MariaDB 官方 APT 源后安装对应版本。对于应用侧，绝大多数驱动（如 JDBC/Connector-C/PHP mysqlnd）无需改动即可连接 MariaDB。升级/迁移时，建议先备份数据，再按版本路径升级，避免跨大版本直接替换引发风险。
二 常见兼容性问题与修复
- root 本地免密登录与权限插件
- 现象：执行 mysql -u root 报 ERROR 1698 (28000)。Debian 系常将 root 设置为 unix_socket 认证。修复方式一：直接用 sudo 进入（sudo mysql）；方式二：创建业务超级用户并授权；方式三：将 root 改为密码认证（需确保 unix_socket 插件可用）。示例：
- 创建管理员用户：CREATE USER ‘admin’@‘localhost’ IDENTIFIED BY ‘StrongPass!’; GRANT ALL PRIVILEGES ON . TO ‘admin’@‘localhost’ WITH GRANT OPTION; FLUSH PRIVILEGES;
- 或切换为密码认证（示例）：ALTER USER ‘root’@‘localhost’ IDENTIFIED VIA mysql_native_password USING PASSWORD(‘StrongPass!’); FLUSH PRIVILEGES;
- 安装/连接时报找不到 mysql.h 或驱动编译失败
- 现象：编译依赖或应用构建时提示找不到 MySQL 头文件/库。Debian 使用 MariaDB 的 Connector/C，需安装 libmariadb-dev-compat 等兼容包，它会在 /usr/include/mysql 建立指向 MariaDB 头文件的符号链接，解决“期望 MySQL 头文件却实际安装 MariaDB”的兼容问题。
- 与 MySQL 共存或来回切换导致冲突
- 建议一次只保留一个数据库栈。若需从 MariaDB 切换到 MySQL（或反向），应先彻底移除现有组件与数据目录，再添加目标官方源进行安装，避免库文件与服务的混合残留引发启动/依赖错误。
- LAMP/PHP 连接问题
- 确保安装与 PHP 版本匹配的模块（如 php-mysql 或 php8.2-mysql），并重启 Apache/PHP-FPM；排查 /var/log/apache2/error.log 与 /var/log/mysql/error.log 定位连接/权限类报错。
三 安装与迁移建议
- 标准安装（Debian 默认仓库）
- 更新索引并安装：sudo apt update && sudo apt install mariadb-server mariadb-client
- 安全初始化：sudo mysql_secure_installation（设置 root 密码、移除匿名用户、禁止 root 远程、删除 test 库等）
- 验证：sudo systemctl status mariadb；mysql -u root -p
- 指定版本安装（如 10.6）
- 导入官方源并安装：curl -LsS -O https://downloads.mariadb.com/MariaDB/mariadb_repo_setup && sudo bash mariadb_repo_setup --mariadb-server-version=10.6
- 然后：sudo apt update && sudo apt install mariadb-server mariadb-client
- 从 MySQL 迁移到 MariaDB
- 备份全量数据（物理与逻辑皆可，推荐 mysqldump 全库导出）；卸载 MySQL 相关包；安装 MariaDB；导入数据；按需执行升级/修复（如 mysql_upgrade）；验证业务与权限。
四 快速排查清单
- 包与源：apt policy mariadb-server；若需特定版本，确认已添加正确的 MariaDB APT 源且无第三方源混用。
- 服务与端口：systemctl status mariadb；ss -lntp | grep 3306；确保监听与防火墙策略正确。
- 认证与用户：SELECT user,host,plugin,authentication_string FROM mysql.user; 核对 root 与本机业务用户的认证方式与权限。
- 客户端/驱动：php -m | grep mysql；ldd $(which mysql) | grep mariadb；编译环境确认已安装 libmariadb-dev-compat。
- 日志：tail -n50 /var/log/mysql/error.log /var/log/syslog，优先从报错时间点向上追溯。