Ubuntu 上定位 MySQL 问题的快速流程
一 服务与系统日志先看
- 查看服务状态与最近报错：sudo systemctl status mysql；若失败，执行 sudo journalctl -xeu mysql.service 获取详细上下文。
- 查看 MySQL 错误日志：cat /var/log/mysql/error.log；必要时用 tail -n50 /var/log/mysql/error.log 只看最新行。
- 目的：快速确认是配置、权限、端口、磁盘还是 InnoDB 等哪一类故障。以上路径和命令是 Ubuntu 上的通用做法。
二 启动失败定位
- 配置语法校验：sudo mysqld --validate-config，优先排除“Unknown variable/Invalid configuration”等参数错误。
- 目录权限与运行用户：确保数据目录与日志目录归属正确，例如 sudo chown -R mysql:mysql /var/lib/mysql；如目录缺失，创建并赋权 sudo mkdir -p /var/log/mysql && sudo chown mysql:mysql /var/log/mysql。
- 端口冲突：检查 3306 是否被占用，sudo netstat -tulpen | grep 3306；必要时 kill 冲突进程或修改 my.cnf 的 port。
- 资源与空间：df -h 检查磁盘；free -m 检查内存；InnoDB 启动异常时，可在 my.cnf 的 [mysqld] 中临时设置 innodb_force_recovery=1（逐级到 6，能起则立即备份，再重建/修复）。
- 手动前台启动定位：sudo -u mysql mysqld --defaults-file=/etc/mysql/my.cnf --datadir=/var/lib/mysql；能启动说明问题多在 systemd 或环境。
- 修改配置后重启：sudo systemctl restart mysql 并复核状态与日志。
三 连接失败定位
- 本机 socket 连不上：/tmp/mysql.sock 不存在或路径不对，常见于服务未起或 socket 目录权限异常；可确认服务运行并修正 /var/run/mysqld 权限：sudo mkdir -p /var/run/mysqld && sudo chown mysql:mysql /var/run/mysqld。
- 远程连不上：
- 防火墙放行：sudo ufw status；sudo ufw allow 3306/tcp。
- 配置监听：检查 /etc/mysql/mysql.conf.d/mysqld.cnf 中 bind-address（如 0.0.0.0 允许远程，127.0.0.1 仅本机）。
- 用户权限：确保存在 ‘user’@‘%’ 或对应来源主机的授权；必要时执行 GRANT … TO ‘user’@‘%’ IDENTIFIED BY ‘pwd’; FLUSH PRIVILEGES;
- 认证失败与主机被封：
- ERROR 1045：核对用户名/密码/主机；必要时重置密码或在 mysql.user 中修正 host 与 plugin。
- Host is blocked：执行 mysqladmin -u root -h flush-hosts 解除封禁。
- 网络连通：ping 与 telnet 3306 验证链路与端口可达。
四 配置文件与安装位置定位
- 查找客户端与服务文件：which mysql；dpkg -L mysql-server（列出安装文件与路径）。
- 查找配置文件：/etc/mysql/my.cnf、/etc/mysql/mysql.conf.d/*.cnf 或 /etc/my.cnf；必要时 sudo find / -name my.cnf。
- 修改配置后务必重启：sudo systemctl restart mysql，并复核 error.log。
五 高频症状速查表
| 症状 |
快速命令 |
常见根因 |
处理要点 |
| 服务起不来 |
systemctl status mysql；journalctl -xeu mysql；cat /var/log/mysql/error.log |
配置错误、权限、端口占用、磁盘满 |
先 --validate-config；修正权限与端口；释放磁盘；必要时 innodb_force_recovery 起服后备份重建 |
| Can’t connect through socket |
cat /var/log/mysql/error.log；ls -l /tmp/mysql.sock |
服务未起、socket 目录权限 |
启动服务；修正 /var/run/mysqld 权限；必要时指定 socket 路径 |
| 远程连不上 |
ufw status；ss -lntp |
防火墙、bind-address、用户权限 |
放行 3306；bind-address 改为 0.0.0.0；授权 ‘user’@‘%’ |
| Access denied |
登录 mysql 执行 SELECT host,user,plugin FROM mysql.user; |
密码/主机/插件不匹配 |
重置密码、调整 host 或 plugin，FLUSH PRIVILEGES |
| Host is blocked |
mysqladmin flush-hosts |
连接错误过多 |
flush-hosts 解除封禁，排查客户端错误原因 |
以上步骤覆盖了 Ubuntu 上 MySQL 常见故障的“看日志→定位类别→对症修复”的最短路径，优先从日志与配置入手，配合权限、端口、网络与资源检查，通常可在数分钟内定位并恢复。