SQLAdmin 在 CentOS 上的故障排查方法
一 快速定位问题
- 明确症状：是页面打不开（如 404/502）、登录后白屏、页面加载缓慢，还是连接数据库失败。
- 复现路径：记录访问的URL、端口、账号，在浏览器按 F12 打开开发者工具查看 Console/Network 报错。
- 服务与端口：确认 Web 服务（如 Apache/Nginx）与数据库（如 MySQL 3306、SQL Server 1433）均在运行并监听正确端口。
- 日志优先：第一时间查看 Web 服务错误日志、SQLAdmin 日志与数据库错误日志，定位报错关键词（如 denied、timeout、refused）。
二 常见故障与处理对照表
| 症状 |
优先检查 |
快速修复 |
| 访问页面 404 |
Web 根目录与 Alias/虚拟主机配置 |
校正 DocumentRoot 与目录权限，确保 SQLAdmin 目录包含在虚拟主机配置中 |
| 页面加载缓慢 |
网络质量、数据库负载、SQLAdmin 配置 |
测延迟/丢包，检查慢查询与索引，优化 SQLAdmin 连接池与超时 |
| 无法连接数据库 |
数据库是否运行、连接参数、网络连通 |
启动数据库；核对主机、端口、用户名、密码；用命令行工具直连验证 |
| 登录后白屏或样式错乱 |
静态资源加载失败、浏览器兼容 |
检查浏览器控制台 404/JS 错误；确认 CSS/JS 路径与权限；换浏览器测试 |
| 权限不足 |
数据库账号权限 |
为 SQLAdmin 所用账号授予所需库/表权限（如 SELECT、SHOW DATABASES 等） |
| 访问被拒绝或间歇性失败 |
防火墙、SELinux、端口监听 |
放行对应端口（如 3306/1433）；必要时临时 setenforce 0 验证 SELinux 影响 |
以上要点与处置思路适用于 SQLAdmin 管理 MySQL/PostgreSQL 的常见场景；若管理 SQL Server，端口通常为 1433。
三 分步排查清单
- 步骤 1 服务与端口
- 查看 Web 服务：systemctl status httpd 或 nginx；确认监听 80/443。
- 查看数据库：
- MySQL：systemctl status mysqld；ss -lntp | grep 3306
- SQL Server：systemctl status mssql-server；ss -lntp | grep 1433
- 步骤 2 防火墙与 SELinux
- 放行端口：firewall-cmd --permanent --add-port=3306/tcp 或 1433/tcp；firewall-cmd --reload
- SELinux：setenforce 0 临时验证；排查失败则改为策略放行或永久调整（不建议长期关闭 SELinux）
- 步骤 3 数据库连通性验证
- MySQL：mysql -h 127.0.0.1 -P 3306 -u 用户名 -p
- SQL Server：sqlcmd -S 服务器IP或主机名 -U 用户名 -P 密码
- 步骤 4 Web 与权限
- 校验 SQLAdmin 配置文件中的 host/port/user/password 与数据库实际一致。
- 检查运行用户对 SQLAdmin 目录的 读/执行 权限与日志目录可写。
- 浏览器 F12 检查 Network 状态码与 Console 报错，修复静态资源与跨域等问题。
四 日志与监控
- 日志查看与分析
- Web 服务错误日志：/var/log/httpd/error_log 或 /var/log/nginx/error.log
- SQLAdmin 日志：/var/log/ 下与 sqladmin 相关的文件（按实际安装路径为准）
- 数据库错误日志：
- MySQL：/var/log/mysqld.log（可用 grep/awk 检索 ERROR）
- SQL Server：journalctl -u mssql-server 或 /var/opt/mssql/log/errorlog
- 系统侧：journalctl -xe、dmesg 用于排查系统级异常
- 日志轮转与保留
- 使用 logrotate 管理 SQLAdmin 与数据库日志，控制单文件体积与保留天数，示例：
/var/log/sqladmin/*.log { daily rotate 7 missingok notifempty compress delaycompress sharedscripts }
- 性能与可用性监控
- 系统资源：top/htop、vmstat、iostat、netstat、dstat、sar
- 数据库：mysqladmin status/extended-status（MySQL）
- 可视化与告警：Prometheus + Grafana、Zabbix、Nagios、PMM（MySQL/MariaDB 场景）
五 场景化排查要点
- 管理 MySQL/MariaDB
- 确认 mysqld 运行；必要时用临时密码登录并修改密码（grep ‘temporary password’ /var/log/mysqld.log）。
- 允许远程：/etc/my.cnf 中设置 bind-address=0.0.0.0；重启 mysqld；防火墙放行 3306。
- 用 mysql 命令行直连验证账号与权限，再回到 SQLAdmin 复测。
- 管理 SQL Server
- 确认 mssql-server 运行；启用 TCP/IP 并确认端口 1433；重启服务。
- 防火墙放行 1433；用 sqlcmd 直连验证；若仅本机能连而远程失败，优先排查防火墙与 SELinux。