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;

四、安全与最佳实践

• 不建议长期使用 root 远程；为应用创建最小权限的专用账号，并限制来源网段（如 'app'@'192.168.1.%'）。
• 仅必要时开放 3306/TCP，并优先采用 SSH 隧道 或 SSL 加密 访问数据库。
• 修改 bind-address 后及时重启服务并复核监听：ss -lntp | grep 3306，确认监听在 0.0.0.0:3306。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！