Debian MariaDB连接失败怎么解决

Debian 上 MariaDB 连接失败的排查与修复

一、先快速定位问题

确认服务是否运行：sudo systemctl status mariadb，若未运行执行 sudo systemctl start mariadb 并设置开机自启 sudo systemctl enable mariadb。
本地能否连上：mysql -u root -p，若本地也失败，多为服务未启动或本地 socket/权限问题。
远程连通性测试：
- 端口是否可达：nc -vz 服务器IP 3306 或 telnet 服务器IP 3306。
- 云服务器需放行安全组/防火墙的 3306/TCP。
查看错误码：
- ERROR 2002 (HY000) 常见于服务未启动、端口不通、bind-address 限制或 socket 问题。
- ERROR 2003 / 10061 常见于端口未放行或监听地址不对。
- ERROR 1698 (28000) 常见于 root 本地认证插件导致本地登录被拒。

二、常见原因与对应修复

服务未启动或异常退出：启动并设置自启，再测试连接。
监听地址限制：编辑 /etc/mysql/mariadb.conf.d/50-server.cnf，将 bind-address = 127.0.0.1 改为 bind-address = 0.0.0.0（或注释该行），保存后 sudo systemctl restart mariadb。注意 MariaDB 仅支持一个 bind-address。
防火墙/安全组未放行：
- firewalld：sudo firewall-cmd --add-port=3306/tcp --permanent && sudo firewall-cmd --reload
- ufw：sudo ufw allow 3306/tcp
- 云厂商安全组需对来源 IP 放行 3306/TCP。
用户权限未允许远程：
- 登录 MariaDB：sudo mysql -u root -p
- 创建远程用户并授权：CREATE USER '用户名'@'%' IDENTIFIED BY '密码'; GRANT ALL PRIVILEGES ON *.* TO '用户名'@'%' WITH GRANT OPTION; FLUSH PRIVILEGES;
- 若客户端老版本兼容旧密码插件：ALTER USER '用户名'@'%' IDENTIFIED WITH mysql_native_password BY '密码'; FLUSH PRIVILEGES;
root 本地登录被拒（ERROR 1698）：sudo mysql -u root -p 进入后执行 UPDATE mysql.user SET plugin='' WHERE user='root'; FLUSH PRIVILEGES;（Debian/Ubuntu 系常见）。

三、按场景给出最小可行命令清单

远程连接时报错 2003/10061（端口不通或监听不对）
1. sudo sed -i 's/^bind-address\s*=.*/bind-address = 0.0.0.0/' /etc/mysql/mariadb.conf.d/50-server.cnf
2. sudo systemctl restart mariadb
3. sudo firewall-cmd --add-port=3306/tcp --permanent && sudo firewall-cmd --reload
4. 云服务器安全组放行 3306/TCP
5. 验证：nc -vz 服务器IP 3306 应返回 succeeded
6. 授权远程用户（见上节）后，客户端：mysql -h 服务器IP -P 3306 -u 用户名 -p
本地 socket 报错 2002（Can’t connect to local MySQL server through socket）
1. sudo systemctl status mariadb（若 inactive 则 sudo systemctl start mariadb）
2. 再次尝试：mysql -u root -p
root 本地登录报错 1698（Access denied for user ‘root’@‘localhost’）
1. sudo mysql -u root -p
2. USE mysql;
3. UPDATE user SET plugin='' WHERE user='root';
4. FLUSH PRIVILEGES;

四、安全与最佳实践

最新问答