DebianMariaDB故障排查技巧

Debian MariaDB故障排查技巧

一 快速定位与日志获取

• 查看服务状态与最近错误：
  • 执行：systemctl status mariadb，关注 Active、Main PID、ExecStartPost 等行。
  • 执行：journalctl -u mariadb -xe，按时间定位首次报错位置。
• 定位 MariaDB 错误日志：
  • 常见路径：/var/log/mariadb/error.log 或 /var/log/mysql/error.log。
  • 若自定义了配置，可在 /etc/my.cnf 或 /etc/mysql/my.cnf 的 [mysqld] 段查看 log_error 项。
• 日志快速筛选：
  • 查看尾部：tail -n 50 /var/log/mariadb/error.log
  • 关键词：grep -i “failed|error|access denied” /var/log/mariadb/error.log
  • 时间段：journalctl -u mariadb --since “2025-12-19 10:00:00” --until “2025-12-19 12:00:00”。

二 常见故障与修复

• 启动时遭遇阻碍，系统给出提示：“ExecStartPost=/etc/mysql/debian-start … code=exited, status=2/203”

  • 现象：安装或升级后 debian-start 脚本缺失或被误删，导致启动脚本退出异常。
  • 修复：
    • 检查是否存在 /etc/mysql/debian-start 或 /etc/mysql/debian-start.dpkg-dist，若存在后者可重命名为前者。
    • 若均不存在，从对应版本的 mariadb-server-*.deb 包中提取：
      • 下载：apt download mariadb-server-<版本>
      • 解压：dpkg-deb --extract mariadb-server-<版本>.deb /tmp/mariadb
      • 复制：cp /tmp/mariadb/etc/mysql/debian-start /etc/mysql/
    • 重启：systemctl start mariadb。

• dpkg配置出现故障：update-alternatives：备用路径/etc/mysql/mariadb.cnf不存在

  • 现象：安装 mariadb-common 时因缺失配置文件导致 dpkg 中断。
  • 修复：
    • 建立占位文件：sudo mkdir -p /etc/mysql && sudo touch /etc/mysql/mariadb.cnf
    • 继续配置：sudo dpkg --configure -a
    • 必要时修复依赖：sudo apt-get install -f
    • 仍异常时可选清理重装相关包。

• 目录缺失导致启动失败（如 /var/log/mariadb 不存在）

  • 现象：日志目录缺失或权限不当，服务启动自检失败。
  • 修复：
    • 创建目录并设权：sudo mkdir -p /var/log/mariadb && sudo chown mysql:mysql /var/log/mariadb
    • 重启：systemctl restart mariadb。

• InnoDB 日志损坏或异常导致无法启动

  • 现象：错误日志含 InnoDB: Corrupted file-level record / Plugin ‘InnoDB’ init function returned error。
  • 修复（只读导出优先）：
    • 编辑配置 /etc/mysql/mariadb.conf.d/50-server.cnf（或 /etc/my.cnf.d/server.cnf），在 [mysdb] 加入：
      • innodb_force_recovery=1（从 1 开始逐步尝试，最高到 6；达到可启动即停）
    • 重启后立刻逻辑备份：mysqldump -A --single-transaction --routines --triggers --hex-blob > backup.sql
    • 备份完成，移除 innodb_force_recovery 并正常重启；如仍失败，用备份重建实例。

• 套接字连接失败 ERROR 2002 (HY000): Can’t connect to local MySQL server through socket

  • 现象：服务未运行或 socket 路径不一致。
  • 排查：
    • 确认运行状态：systemctl is-active mariadb
    • 查看 /etc/mysql/my.cnf 中 [mysqld] socket 与客户端 [client] socket 是否一致
    • 检查目录与权限：ls -ld /var/run/mysqld && sudo systemctl restart mariadb
    • 临时直连测试：mysql -u root -p -h 127.0.0.1 --protocol=tcp（绕开 socket）。

三 安全加固与远程访问

• 首次加固：
  • 执行：sudo mysql_secure_installation，设置 root 密码、移除匿名用户、禁止远程 root 登录、删除测试库。
• 启用远程访问（按需）：
  • 编辑：sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf
  • 设置：bind-address = 0.0.0.0（或指定内网网段）
  • 重启：sudo systemctl restart mariadb
  • 授权示例（仅示例，生产环境请使用强密码与最小权限）：
    • GRANT ALL PRIVILEGES ON . TO ‘root’@‘%’ IDENTIFIED BY ‘YourStrongPassword’ WITH GRANT OPTION;
    • FLUSH PRIVILEGES;

四 主从复制场景的排查要点

• 提升从库为主库：
  • 选择复制最接近主的从库（比较 Exec_Master_Log_Pos 或 relay-log.info 位置）。
  • 在候选从库启用二进制日志：server-id=唯一值；log-bin，重启。
  • 其他从库执行：STOP SLA VE; RESET SLA VE ALL; 后 CHANGE MASTER TO … 指向新主，最后 START SLA VE; 检查 Sla ve_IO_Running/Sla ve_SQL_Running=YES。
• 复制中断跳过错误（谨慎）：
  • 临时跳过单个事件：STOP SLA VE; SET GLOBAL sql_sla ve_skip_counter=1; START SLA VE;
  • 批量跳过特定错误码：在配置加入 sla ve_skip_errors=1007（静态变量，需重启）。

五 最小化排查清单

• 服务状态：systemctl status mariadb；实时日志：journalctl -u mariadb -f
• 错误日志：/var/log/mariadb/error.log 或 /var/log/mysql/error.log
• 配置核对：/etc/mysql/my.cnf、/etc/mysql/mariadb.conf.d/*.cnf 的 datadir、socket、log_error、bind-address
• 目录与权限：/var/lib/mysql（属主 mysql:mysql）、/var/run/mysqld、/var/log/mariadb
• 套接字与端口：本地用 mysql -h 127.0.0.1 --protocol=tcp 测试；远程用 telnet 主机 3306
• 强制恢复：仅在备份优先前提下用 innodb_force_recovery=1→6 逐级尝试并尽快导出数据

注意：涉及数据删除、强制恢复与权限变更的操作存在数据丢失与安全风险，务必先做好完整备份，并在非生产环境验证后再实施。