直接用 mysql
命令连一下就知道了
最快速的判断方式不是查进程、看端口或翻配置文件,而是模拟真实使用场景:尝试连接数据库。只要
mysql客户端能成功执行一次简单查询,就说明环境基本可用。
执行以下命令(假设默认用户
root,无密码):
mysql -u root -e "SELECT 1;"
如果返回
1,说明客户端存在、服务端响应正常、认证通过;如果报错,再根据错误细分原因:
command not found: mysql→ 客户端未安装或未加入
$PATH
Can't connect to local MySQL server→ 服务未启动,或监听地址/端口不匹配(比如 mysqld 绑定了
127.0.0.1:3307,但你连的是默认
3306)
Access denied for user→ 用户名/密码错误,或权限不足(如只允许从
localhost连,但你用了
127.0.0.1)
检查 mysqld
进程和监听端口是否就绪
命令行工具不可用时,退一步确认服务进程和网络层状态。注意:Linux 下进程名是
mysqld(带
d),不是
mysql;macOS Homebrew 安装后可能叫
mysql.server或
mysqld_safe,但实际工作进程仍是
mysqld。
检查进程:
ps aux | grep mysqld | grep -v grep
检查端口(默认
3306,但配置可能改过):
netstat -tlnp | grep :3306
或用
lsof(macOS/Linux 都支持):
lsof -i :3306
常见坑:
MySQL 8.0+ 默认绑定127.0.0.1,不监听
0.0.0.0,
netstat显示的是
127.0.0.1:3306而非
*:3306,这属于正常行为,不影响本地连接 Docker 容器内运行时,
localhost指向容器自身,若没启动 mysqld 就会连不上——得先
docker exec -it xxx ps aux | grep mysqld
验证配置文件是否加载成功且语法正确
MySQL 启动失败常因配置错误(比如
my.cnf里写了不存在的参数),但进程可能“假启动”:进程存在,却无法响应连接。这时需要看错误日志,而不是只看进程是否存在。
找到配置文件位置(优先级:命令行 >
/etc/my.cnf>
/etc/mysql/my.cnf>
$HOME/.my.cnf):
mysql --help | grep "Default options" -A 1
验证配置语法(不会启动服务,只做静态检查):
mysqld --defaults-file=/etc/my.cnf --validate-config
若提示
unknown variable或
invalid option,说明该配置项在当前 MySQL 版本中不被支持(例如
default-character-set在 8.0+ 已废弃)。
关键点:
--validate-config是 5.7.19+ 和 8.0.1+ 才支持的选项,旧版本只能靠启动时重定向 stderr 看日志 配置中若混用
skip-networking和
bind-address,可能导致服务起来但拒绝所有 TCP 连接
用脚本批量检测关键指标(连接 + 权限 + 基础查询)
运维或 CI 场景下,需要更完整的“可用性”定义:不仅要连上,还要能执行查询、有足够权限建临时表、时区设置合理等。下面是一个最小可行检测脚本(bash):
#!/bin/bash
DB_USER="root"
DB_PASS=""
DB_HOST="127.0.0.1"
DB_PORT="3306"
<h1>测试连接与基础响应</h1><p>if ! mysql -h "$DB_HOST" -P "$DB_PORT" -u "$DB_USER" -p"$DB_PASS" -e "SELECT 1;" &>/dev/null; then
echo "FAIL: Cannot connect or execute basic query"
exit 1
fi</p><h1>测试是否能创建临时表(某些只读账户会禁用)</h1><p>if ! mysql -h "$DB_HOST" -P "$DB_PORT" -u "$DB_USER" -p"$DB_PASS" -e "CREATE TEMPORARY TABLE _test (id INT); DROP TEMPORARY TABLE _test;" &>/dev/null; then
echo "WARN: No permission to create temporary tables"
fi</p><h1>检查系统变量(如 time_zone 是否为 'SYSTEM' 或合法值)</h1><p>TZ=$(mysql -h "$DB_HOST" -P "$DB_PORT" -u "$DB_USER" -p"$DB_PASS" -Nse "SELECT @@time_zone;")
if [[ "$TZ" == "SYSTEM" ]] || [[ "$TZ" =~ ^[+-][0-9]{2}:[0-9]{2}$ ]]; then
echo "OK: time_zone = $TZ"
else
echo "WARN: unusual time_zone value: $TZ"
fi这个脚本不依赖外部工具,只用原生
mysql客户端,适合嵌入部署流程。注意:
-N去掉列名,
-s简化输出,避免解析干扰。
真正容易被忽略的是权限粒度和上下文差异:本地
localhost认证走 socket,而
127.0.0.1走 TCP,两者对应的 MySQL 用户记录可能是分开的;Docker 网络模式(host vs bridge)也会影响
bind-address的实际生效效果。
