ERROR 2003 主因是连接未抵达 mysqld 进程，最常见为 bind-address 配置错误；需用 netstat/ss 查监听状态，确认是否为 0.0.0.0:3306 或 127.0.0.1:3306，并检查 skip-networking、防火墙、容器端口映射及云安全组。
MySQL 报错 ERROR 2003 (HY000): Can't connect to MySQL server，90% 不是密码错，而是连接请求压根没抵达 mysqld 进程——bind-address 配置错误是最常见原因。
确认 mysqld 是否监听外部 IP
先别改配置，用系统命令看真实监听状态：
- 执行
sudo netstat -tuln | grep :3306或sudo ss -tuln | grep :3306 - 若输出是
127.0.0.1:3306或localhost:3306，说明只接受本机 TCP 连接 - 若输出是
*:3306或0.0.0.0:3306，说明已监听所有 IPv4 接口 - 若无任何输出，说明 mysqld 没启动、
skip-networking开启了，或端口被占
修改 bind-address 配置项
找到生效的配置文件（常见路径：/etc/mysql/mysql.conf.d/mysqld.cnf、/etc/my.cnf、/usr/etc/my.cnf），在 [mysqld] 段下检查/修正：
- 必须显式设置
bind-address = 0.0.0.0（允许所有 IPv4）或指定内网 IP（如bind-address = 192.168.1.10） - 严禁留空、写成
bind-address = 127.0.0.1、或带多余空格（如bind-address = 127.0.0.1） - 确认没有启用
skip-networking = 1—— 一旦开启，TCP/IP 连接完全禁用 - 改完后必须重启服务：
sudo systemctl restart mysql（Debian/Ubuntu）或sudo systemctl restart mysqld（RHEL/CentOS）；reload不生效
Docker 容器里 bind-address 失效怎么办
即使容器内 my.cnf 设了 bind-address = 0.0.0.0，仍连不上，大概率卡在三处：
- 运行容器时漏了端口映射：
docker run -p 3306:3306 ...缺失则宿主机无法转发 - 容器使用了
--network=host模式，但宿主机防火墙（如 ufw）仍拦截 3306 - MySQL 镜像默认配置可能覆盖你挂载的
my.cnf，建议用docker exec -it mysql-container cat /etc/mysql/mysql.conf.d/mysqld.cnf确认最终加载内容 - 云环境（如 AWS RDS）根本禁用
bind-address参数——此时该错误 100% 是安全组或 VPC 路由问题，不用查配置文件
验证时容易忽略的关键点
很多人改完 bind-address 就以为万事大吉，但以下环节任一缺失都会让 2003 复现：
- 客户端用
mysql -h localhost -P 3306测试？这会走 Unix socket，不是 TCP，不触发bind-address逻辑；应强制走 TCP：mysql -h 127.0.0.1 -P 3306 - 用户权限里的
host是'user'@'localhost'？它和'user'@'127.0.0.1'是两个不同账户，远程连接需匹配'user'@'%'或具体 IP - Linux 防火墙（ufw/firewalld）和云平台安全组是两套独立策略，都得放行 3306 入站
-
mysqld --validate-config可提前检查配置语法，避免重启失败却无报错
真正难排查的不是 bind-address 本身，而是它和其他层（网络、权限、容器、云策略）交织时产生的“假成功”：比如 telnet 通了但还是报 2003，说明请求到了 mysqld，但被权限或认证插件拦下了——这时候就不是 bind-address 的事了。
