centos里sqladmin故障排查

CentOS 上 SQLAdmin 故障排查手册

一 快速定位思路

• 明确对象：SQLAdmin 常见指代两类管理工具——
  1. 基于 Web 的数据库管理工具（如 phpMyAdmin、Adminer 等，常被称作“SQL Admin”）；
  2. 命令行工具 mysqladmin（用于 MySQL/MariaDB 的健康检查与管理）。
• 先判“服务/进程是否在”：
  • Web 类：检查 Web 服务与程序是否运行（如 systemctl status httpd|nginx），并查看应用日志（如 /var/log/httpd/error_log 或应用自身日志）。
  • mysqladmin：先确认数据库是否存活（如 mysqladmin ping 或 systemctl status mysqld）。
• 再查“能否连通”：本机用 localhost 直连，远程用 IP/域名+端口 测试；必要时用 telnet/nc 探测端口连通性。
• 后看“权限与配置”：数据库账户权限、连接参数（主机、端口、socket）、Web 端连接配置是否正确。
• 最后看“系统资源与系统层限制”：磁盘空间、内存、I/O、SELinux/防火墙策略等。

二 Web 类 SQLAdmin 排查步骤

• 服务与进程：确认 httpd/nginx 已启动且未报错；若使用 php-fpm，一并检查其运行状态与日志。
• 访问与错误：访问具体页面（如 /phpmyadmin 或自定义别名），若出现 404/403/500，优先核对 Web 配置中 Alias/DocumentRoot、目录权限与 SELinux 上下文。
• 连通性：在服务器本机用 curl -I http://127.0.0.1/phpmyadmin 验证；远程用 curl/curl -v 观察返回码与跳转。
• 数据库连通：在 Web 配置中核对数据库 主机、端口、用户名、密码；若仅本地可连，远程失败，多半是数据库未监听外网或防火墙/安全组未放行。
• 页面异常：打开浏览器开发者工具（F12）查看 Console/Network 报错；若 CSS/JS 加载失败，多为静态资源路径或权限问题。
• 日志定位：同时查看 Web 服务错误日志与应用日志（常见路径：/var/log/httpd/、/var/log/nginx/ 或应用目录下的 logs/）。

三 mysqladmin 命令行排查步骤

• 存活探测：执行 mysqladmin ping，返回 mysqld is alive 表示数据库进程存活；若超时或拒绝，转向数据库层排查。
• 服务状态：执行 systemctl status mysqld，若未运行则 systemctl start mysqld 并观察启动日志。
• 本机 socket 连接失败：出现 “Can’t connect to local MySQL server through socket” 时，核对 /etc/my.cnf 中 [mysqld]/[client]/[mysqladmin] 的 socket 路径一致，并确保目录属主为 mysql:mysql。
• 认证失败：出现 “Access denied for user ‘root’@‘localhost’” 时，检查账户、密码与 host 匹配；必要时在维护窗口重置 root 密码并更新权限。
• 端口连通：远程连接失败用 telnet your_ip 3306 或 nc -vz your_ip 3306 验证端口可达性；不通则排查数据库 bind-address、云安全组/本机防火墙策略。
• 日志与资源：查看 /var/log/mysqld.log 获取启动/认证/权限错误细节；同时检查 磁盘空间(df -h)、I/O(iostat) 等系统资源是否异常。

四 高频故障与修复对照表

五 进一步监控与预防

• 系统资源与健康：使用 top/htop、vmstat、iostat、dstat、sar 观察 CPU、内存、磁盘 I/O、网络 的异常波动。
• 数据库层监控：使用 mysqladmin status/extended-status、慢查询日志与性能模式（Performance Schema）定位瓶颈。
• 可视化与告警：部署 Prometheus + Grafana 或 Zabbix 做指标可视化与阈值告警；MySQL 可用 PMM 获取更细粒度指标。
• 例行维护：定期更新 系统与软件包、备份配置与数据、审计账户权限与网络策略，减少故障面。