Linux MariaDB常见问题及解决方法

Linux MariaDB常见问题与排查清单

一 服务无法启动

• 快速定位
  • 查看服务状态与系统日志：使用命令：systemctl status mariadb、journalctl -xe，优先关注与 MariaDB 相关的报错行与时间线。
  • 查看错误日志：常见路径为 /var/log/mysql/error.log 或 /var/log/mariadb/mariadb.log；实时跟踪可用：tail -fn 30 /var/log/mariadb/mariadb.log。
  • 检查端口冲突：确认 3306 是否被占用，命令：ss -tulnp | grep 3306 或 netstat -tulnp | grep 3306。
  • 检查配置文件：核对 /etc/my.cnf、/etc/mysql/my.cnf 或 /etc/mysql/mariadb.conf.d/ 下的参数与路径是否一致、合法。
  • 检查资源与目录：用 df -h 确认磁盘空间；确认数据目录（如 /var/lib/mysql）与日志目录（如 /var/log/mariadb）存在且权限正确（属主 mysql:mysql）。
  • 依赖与库：若启动二进制报错缺少库（如 libaio.so.1、libnuma.so.1），安装对应包（如 libaio、numactl），并用 ldd /usr/sbin/mysqld 验证依赖是否解析成功。
  • 初始化与多实例：新环境需初始化系统库（如 mysql_install_db --user=mysql --datadir=…）；若提示 InnoDB: Unable to lock ./ibdata1, error: 11，多为目录被占用或已有实例运行，使用 ps aux | grep mysql 查找并终止多余进程，或调整端口/实例目录。

二 无法连接数据库

• 服务与网络
  • 确认服务运行：systemctl status mariadb；远程访问时，确保监听 0.0.0.0:3306 而非仅 127.0.0.1，并开放防火墙/安全组端口 3306。
  • 连通性测试：在客户端执行 mysql -h -P 3306 -u -p；或用 telnet 3306、nc -zv 3306 验证端口可达。
• 认证与权限
  • 核对账户主机限制与密码：如 ‘root’@‘localhost’ 与 ‘root’@‘%’ 不同；必要时重置密码：ALTER USER ‘’@‘’ IDENTIFIED BY ‘new_password’; 并 FLUSH PRIVILEGES;。
  • 本地 socket 错误（如 ERROR 2002 (HY000)）：检查客户端与服务器 socket 路径是否一致（常见 /var/lib/mysql/mysql.sock 与 /tmp/mysql.sock）；可在 my.cnf 统一路径，或创建软链：ln -s /var/lib/mysql/mysql.sock /tmp/mysql.sock。

三 性能慢与资源瓶颈

• 监控与定位
  • 数据库状态：SHOW STATUS;、SHOW PROCESSLIST;；系统资源：top/htop、iostat；连接与监听：ss -tulnp | grep mariadb。
• 配置优化（示例，按内存与负载调整）
  • InnoDB 缓冲池：innodb_buffer_pool_size = 物理内存的 50%–75%（如 4G/8G）；
  • 日志与提交策略：innodb_log_file_size = 256M；innodb_flush_log_at_trx_commit = 2（更高性能、略降持久性）；
  • 查询与临时表：query_cache_size = 64M（若版本支持）、max_connections = 500、tmp_table_size = 256M、max_heap_table_size = 256M；
  • 慢查询：开启 slow_query_log=1、设置 long_query_time，用 EXPLAIN 分析执行计划并优化索引/SQL。
• 架构与维护
  • 合理使用索引（组合索引、前缀索引）、避免 **SELECT ***、分页优化；必要时分区/分表；定期 OPTIMIZE TABLE 与清理无用日志。

四 数据安全与日常维护

• 备份与恢复
  • 逻辑备份：mysqldump -u root -p --single-transaction --routines --triggers --databases > backup.sql；恢复：mysql -u root -p < backup.sql。
• 二进制日志与空间
  • 查看与清理：SHOW BINARY LOGS;、PURGE BINARY LOGS BEFORE ‘YYYY-MM-DD HH:MM:SS’;；在配置中设置合理的 expire_logs_days 或 binlog_expire_logs_seconds，避免磁盘被 Binlog 撑满。
• 复制与版本
  • 复制状态：SHOW SLAVE STATUS\G（检查 Slave_IO_Running/Slave_SQL_Running、Exec_Master_Log_Pos 等）；异常时按位点或 GTID 修复并重启复制。
  • 版本升级：使用包管理器执行 yum/dnf update mariadb-server 或 apt-get upgrade mariadb-server，验证版本并重启服务。

五 高频报错速查表