debian mysql为何无法连接

在 Debian 上 MySQL（或 MariaDB）无法连接是比较常见的问题，原因通常集中在服务状态、网络绑定、用户权限、防火墙、Socket 配置这几类。下面按「最常见 → 较少见」帮你系统排查。

一、先确认 MySQL 服务是否运行

systemctl status mysql
# 或 MariaDB
systemctl status mariadb

如果没运行：

sudo systemctl start mysql
sudo systemctl enable mysql

二、本地连接 vs 远程连接（很重要）

1️⃣ 本地连接失败（socket）

常见错误：

Can't connect to local MySQL server through socket '/var/run/mysqld/mysqld.sock'

检查：

ls -l /var/run/mysqld/mysqld.sock

如果不存在：

sudo mkdir -p /var/run/mysqld
sudo chown mysql:mysql /var/run/mysqld
sudo systemctl restart mysql

连接时指定 socket：

mysql -u root -p --socket=/var/run/mysqld/mysqld.sock

2️⃣ 远程连接失败（TCP/IP）

错误示例：

ERROR 2003 (HY000): Can't connect to MySQL server on 'ip' (111)

✅ 检查监听地址

ss -tlnp | grep 3306

如果看到：

127.0.0.1:3306

说明 只允许本地连接

修改配置文件（Debian 常见位置）：

/etc/mysql/mysql.conf.d/mysqld.cnf
# 或
/etc/mysql/mariadb.conf.d/50-server.cnf

找到：

bind-address = 127.0.0.1

改为：

bind-address = 0.0.0.0

然后：

sudo systemctl restart mysql

三、用户权限问题（非常常见）

1️⃣ 用户是否允许远程

SELECT user, host FROM mysql.user;

如果 root 只有 localhost，远程连不上。

创建远程用户：

CREATE USER 'user'@'%' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON *.* TO 'user'@'%';
FLUSH PRIVILEGES;

四、防火墙（Debian 常用 ufw）

sudo ufw status

如果开启：

sudo ufw allow 3306/tcp

⚠️ 公网环境 不建议直接暴露 3306

五、认证插件问题（MySQL 8+）

Debian 新版本可能用：

caching_sha2_password

旧客户端连不上，可改为：

ALTER USER 'user'@'%' IDENTIFIED WITH mysql_native_password BY 'password';

六、AppArmor / SELinux（较少见）

Debian 默认有 AppArmor，一般不影响连接
若数据目录改过，需要改：

/etc/apparmor.d/usr.sbin.mysqld

七、快速自检清单 ✅

[ ] MySQL 是否在运行
[ ] bind-address 是否正确
[ ] 用户 host 是否允许
[ ] 防火墙是否放行
[ ] 使用的是 socket 还是 TCP
[ ] 错误码（2002 / 2003 / 1130）

八、把错误贴出来最快

你可以直接发：

完整报错信息
mysql -u root -p 的结果
ss -tlnp | grep 3306 输出

我可以精准定位是哪一类问题。