Linux MariaDB常见故障如何解决

Linux MariaDB 常见故障与排查步骤

一 服务无法启动

• 快速定位
  • 查看服务状态与系统日志：执行systemctl status mariadb与journalctl -xe，优先关注与 MariaDB 相关的报错行与退出码。
  • 查看错误日志：默认在**/var/log/mariadb/mariadb.log或配置文件/etc/my.cnf中log-error指定路径；使用tail -fn 30 /var/log/mariadb/mariadb.log**实时跟踪。
  • 检查端口与资源：确认3306未被占用（如ss -tulnp | grep 3306），检查磁盘空间（df -h）与内存。
• 高频原因与修复
  • 日志目录缺失或权限不足：创建并授权**/var/log/mariadb**，如：mkdir -p /var/log/mariadb && chown -R mysql:mysql /var/log/mariadb（必要时设置可写）。
  • 数据目录未初始化或权限错误：确保datadir（如**/var/lib/mysql**）为空后执行初始化（示例：mysql_install_db --user=mysql --datadir=/var/lib/mysql），完成后修正权限chown -R mysql:mysql /var/lib/mysql。
  • PID 或运行时目录不可写：创建并授权**/var/run/mariadb**（mkdir -p /var/run/mariadb && chown -R mysql:mysql /var/run/mariadb）。
  • 端口被占用或重复实例：用ss -tulnp | grep 3306定位占用进程，必要时 kill 后重启；避免多实例共用同一数据目录。
  • SELinux/防火墙限制：执行getenforce查看 SELinux；按需放行3306（如 firewall-cmd --add-port=3306/tcp --permanent && firewall-cmd --reload）。
  • 依赖库缺失：如libaio.so.1、libnuma.so.1，安装对应包（如libaio、numactl），并用ldd /usr/sbin/mysqld验证。
  • 配置错误/多配置文件叠加：排查**/etc/my.cnf与/etc/mysql/下多份配置冲突；Windows 拷贝的 my.cnf 可能存在BOM/换行符**，用dos2unix处理。

二 无法连接数据库

• 本地 socket 连接失败（ERROR 2002）
  • 确认服务已启动（systemctl start mariadb）；检查**/etc/my.cnf中socket路径与客户端一致；必要时用mysql --socket=/tmp/mysql.sock**显式指定；若路径不同可创建软链统一。
• 远程连接失败（ERROR 2003/Communications link failure）
  • 确认服务监听与网络：ss -lntp | grep 3306；云主机/安全组需放行3306；本机防火墙放行（firewall-cmd --add-port=3306/tcp --permanent && firewall-cmd --reload）。
  • 检查绑定地址：在**/etc/my.cnf的[mysqld]中设置bind-address=0.0.0.0**（仅在内网可信环境使用），重启服务。
  • JDBC/应用侧：连接串需包含正确host/port，高版本驱动建议useSSL=false/true与serverTimezone等参数匹配；避免连接池超时过短。

三 数据损坏与异常恢复

• InnoDB 异常恢复
  • 异常关机或ib_logfile不一致导致启动失败时，先备份后尝试移走ib_logfile0/1再启动；极端情况下在**[mysqld]加入innodb_force_recover=3**进入恢复模式导出数据，恢复后务必重建实例。
• MyISAM 表损坏
  • 使用myisamchk -c -r /var/lib/mysql/mysql/proc.MYI修复索引，或用CHECK TABLE/REPAIR TABLE在实例内修复；修复前先停库并备份。
• 未正常关闭导致的事务残留
  • 错误提示如“Found prepared transactions”时，启动加入**–tc-heuristic-recover=ROLLBACK**提交或回滚悬挂事务（仅在明确无主从一致性风险时使用）。
• 复制/集群异常
  • 主从复制异常用SHOW SLAVE STATUS核对Master_Log_File/Read_Master_Log_Pos与Relay_Log_File/Exec_Master_Log_Pos；必要时重设复制位点后重启 IO/SQL 线程。
  • Galera/Wsrep 加入集群失败可先注释集群配置以单机模式启动修复，再恢复集群配置。

四 性能与空间问题

• 慢查询
  • 启用慢查询日志：在**[mysqld]设置slow_query_log=1**、long_query_time=1（按业务调整），用mysqldumpslow或 pt-query-digest 分析并优化索引/SQL/结构。
• 磁盘空间耗尽
  • 二进制日志过大：执行SHOW BINARY LOGS查看；按时间清理PURGE BINARY LOGS BEFORE ‘YYYY-MM-DD’；或在配置中限制max_binlog_size与expire_logs_days，避免无限增长。
  • 数据目录所在分区满：清理无用文件/归档历史数据，或迁移datadir至更大磁盘并更新配置与权限后重启。

五 排错命令清单与最小复现步骤

• 常用命令
  • 服务与日志：systemctl status mariadb；journalctl -xe；tail -fn 30 /var/log/mariadb/mariadb.log
  • 网络与端口：ss -tulnp | grep 3306；firewall-cmd --list-ports；getenforce
  • 配置与依赖：cat /etc/my.cnf；ldd /usr/sbin/mysqld；ps -ef | grep mysql
  • 存储与空间：df -h；du -sh /var/lib/mysql /var/log/mariadb
• 最小复现步骤
  • 无法启动：查看状态与日志 → 校验目录/权限/端口/依赖 → 修正后重启；仍失败时以mysqld --verbose --help或前台启动观察输出。
  • 无法连接：确认服务运行 → 校验bind-address/socket → 测试本机与远程连通 → 检查用户权限与防火墙。