Debian 上 MariaDB 的常见问题清单与处理要点
一 安装与版本兼容
- 使用系统默认仓库安装时，版本可能偏旧（如 Debian 12 官方仓库常见为 10.11.x）；若应用需要更新版本，可添加 MariaDB 官方仓库后再安装，例如：使用官方的 setup_repository 脚本或手动添加 .list 文件，执行 apt update 后安装 mariadb-server。注意选择与系统代号（如 bookworm）匹配的仓库；不建议在生产环境使用已 EOL 的旧版本（如 10.3）。安装后可用 mysql -V 或登录后执行 SELECT VERSION(); 验证版本。
二 服务无法启动与升级后异常
- 典型现象是执行 systemctl start mariadb 失败。优先查看状态与日志：systemctl status mariadb、journalctl -xe、/var/log/mysql/error.log。常见根因包括：配置错误、数据目录权限/磁盘空间不足、InnoDB 日志不一致等。升级或异常断电后，可尝试在确保数据安全的前提下清理 InnoDB 日志文件（如 ib_logfile*），再重启；若仍失败，以错误日志为准定位具体原因。另一个 Debian 特有问题是个别环境下 /etc/mysql/debian-start 缺失导致启动后执行脚本失败，可从对应版本的 MariaDB 包中解压该文件恢复后重试。
三 本地与远程连接失败
- 本地连接报错 “ERROR 2002 (HY000): Can’t connect to local MySQL server through socket …” 时，通常是服务未运行或 socket 路径异常。先确认服务状态并启动：systemctl status/start mariadb；必要时检查 /var/run/mysqld 目录权限与存在性。远程连接失败常见于：未开放 3306 端口、MariaDB 仅监听 127.0.0.1、用户权限未放行。处理要点：在防火墙放行 3306（如 firewall-cmd --add-port=3306/tcp --permanent && firewall-cmd --reload）；编辑 /etc/mysql/mariadb.conf.d/50-server.cnf 将 bind-address 改为 0.0.0.0 后重启；仅在内网或受控网络下为 root 等账户授予远程权限（如 GRANT … TO ‘root’@‘%’），生产环境更推荐创建专用账户并限制来源网段。
四 初始密码为空与 debian-sys-maint 维护账户
- 部分 Debian/Deepin 安装后 root 初始密码为空，可直接执行 mysql_secure_installation 设置密码并完成安全加固（移除匿名用户、禁止 root 远程登录、删除 test 库等）。若因密码策略或插件导致修改失败，可在维护模式下重置：停止服务，使用 mysqld_safe --skip-grant-tables --skip-networking 启动，登录后更新 mysql.user 的密码字段并刷新权限；注意不同版本字段名可能为 authentication_string 或 password，操作前先 SELECT user,host,plugin,authentication_string,password FROM mysql.user; 核实。另有场景需要用到 debian-sys-maint 账户执行系统维护任务，其凭据通常在 /etc/mysql/debian.cnf；若该文件缺失或被误改，可能导致包管理操作异常，需从同版本包中恢复或重新配置该账户及权限。
五 性能与配置优化要点
- 基础参数：在 /etc/mysql/mariadb.conf.d/50-server.cnf 中，将 innodb_buffer_pool_size 设为物理内存的约 50%–75%（视负载与内存而定）；根据并发调整 max_connections；必要时开启慢查询日志（slow_query_log）定位问题 SQL。连接与字符集：避免在生产环境使用 --skip-networking；统一 character_set_server/collation_server 与库表字符集，减少乱码与隐式转换。Web 场景（LNMP）：合理配置 bind-address、连接池与 PHP-FPM 的 Unix socket 通信；对高并发应用结合连接池与索引优化，减少长事务与全表扫描。