MySQL连接失败原因解决方法怎么排查？服务器迁移后场景2003 Cant connect to MySQL server错误宝塔面板排查
服务器迁移后时MySQL连接失败，报错2003 Can't connect to MySQL server。连接失败分认证、网络、服务、配置四类原因，按顺序排查快速定位。
认证错误排查。2003 Can't connect to MySQL server中1045表示用户名或密码错误。检查程序配置文件中的数据库用户名、密码、数据库名是否正确。宝塔面板中MySQL默认用户root，密码安装时设置。命令行mysql -u root -p测试登录，确认密码正确。密码忘记时跳过权限表重置：mysqld_safe --skip-grant-tables启动，UPDATE user SET authentication_string=PASSWORD('新密码') WHERE User='root'，FLUSH PRIVILEGES。
网络连接排查。2003 Can't connect to MySQL server中2003和10060是网络不通。检查MySQL服务是否监听3306端口，netstat -tlnp | grep 3306查看。宝塔面板中云服务器安全组是否放行3306端口，防火墙firewalld或iptables是否开放。本地连接用localhost走socket，远程连接用IP走TCP，服务器迁移后中远程连接必须确保端口可达。
服务运行排查。systemctl status mysqld查看MySQL服务状态，未运行则systemctl start mysqld启动。宝塔面板中Docker容器docker ps查看MySQL容器状态，未启动docker start容器名。服务启动失败看错误日志/var/log/mysqld.log，常见原因是配置文件my.cnf语法错误或磁盘满。
权限配置排查。2003 Can't connect to MySQL server中1130表示IP不允许连接。MySQL用户的host字段限制登录来源，root用户默认host为localhost，远程连接需创建远程用户：CREATE USER '用户名'@'%' IDENTIFIED BY '密码'; GRANT ALL PRIVILEGES ON *.* TO '用户名'@'%' WITH GRANT OPTION; FLUSH PRIVILEGES。服务器迁移后中生产环境不建议用%允许所有IP，指定具体IP更安全。
配置文件排查。my.cnf中bind-address=127.0.0.1只允许本地连接，远程连接需注释掉或改为0.0.0.0。skip-networking参数禁止TCP连接，需注释。宝塔面板中修改配置后重启MySQL服务生效。服务器迁移后中连接失败通常是以上原因之一，逐一排查10分钟内解决。
更新时间：2026-08-26 21:59:37