sqlstate[hy000] [2002]连接被拒绝的根源是pdo无法建立到mysql服务器的网络或socket连接，需按五步排查：一、确认mysql服务运行状态；二、检查端口监听与防火墙；三、核对连接参数及主机名解析；四、验证socket路径与权限；五、检查用户权限与认证插件兼容性。

如果您在运行PHP或ThinkPHP6等应用时遇到SQLSTATE[HY000] [2002]连接被拒绝错误，说明PDO尝试建立数据库连接时被目标服务器主动拒绝。以下是排查该问题的具体路径：

一、验证MySQL服务运行状态

该步骤用于确认数据库进程是否处于活动监听状态，避免因服务未启动导致的连接中断。

1、在Linux系统中执行 systemctl status mysql 或 systemctl status mysqld 查看服务当前状态。

2、若显示“inactive (dead)”，则运行 sudo systemctl start mysql 启动服务。

3、在Windows系统中，按下 Win + R，输入 services.msc，定位“MySQL”或“MySQL80”服务，右键选择“启动”。

4、启动后再次执行状态命令，确认输出中包含“active (running)”字样。

二、检查数据库端口监听与网络可达性

该步骤用于识别端口是否被正确绑定、监听，以及是否存在防火墙或网络策略拦截连接请求。

1、执行 netstat -tulnp | grep :3306（Linux）或 netstat -ano | findstr :3306（Windows），确认MySQL进程是否在3306端口（或自定义端口）上监听。

2、若无输出，检查MySQL配置文件中 port 参数值，并确认 bind-address 未设为 127.0.0.1（若需远程连接）或 0.0.0.0（允许所有接口）。

3、使用 telnet 127.0.0.1 3306 测试本地端口连通性；若失败，检查防火墙规则：sudo ufw status（Ubuntu）或 Windows Defender 防火墙高级设置 中是否放行3306端口。

4、如部署于云环境（如阿里云RDS），还需确认安全组规则已开放对应端口，且ECS与RDS处于同一VPC并添加了ECS内网IP至RDS白名单。

三、核对连接参数与主机名解析

该步骤用于排除因配置错误或DNS解析异常引发的地址不可达问题。

1、检查应用配置文件（如ThinkPHP6的.env或database.php）中 hostname 值：若为 localhost，部分系统会强制走Unix socket；可尝试替换为 127.0.0.1 强制走TCP协议。

2、若使用域名或自定义主机名（如db.example.com），执行 ping db.example.com 或 nslookup db.example.com 验证是否能正常解析出IP地址。

3、在Docker环境中，确认应用容器与数据库容器是否位于同一自定义网络，且连接时使用的是 docker-compose.yml中定义的服务名（如db），而非localhost或127.0.0.1。

4、检查系统hosts文件（/etc/hosts 或 C:\Windows\System32\drivers\etc\hosts）是否存在错误的静态映射条目干扰解析。

四、确认套接字路径与权限配置

该步骤适用于本地通过socket文件连接MySQL的场景，用于解决因路径不一致或权限不足导致的拒绝连接。

1、执行 mysql --help | grep "Default options" 或查看MySQL错误日志，定位实际使用的socket路径（常见为 /var/run/mysqld/mysqld.sock 或 /tmp/mysql.sock）。

2、运行 sudo ls -l /var/run/mysqld/mysqld.sock 检查该文件是否存在且权限允许当前Web用户（如www-data、nginx）访问。

3、若路径不一致，在PHP连接字符串中显式指定socket，例如：mysql:unix_socket=/var/run/mysqld/mysqld.sock;dbname=test。

4、若配置文件中存在 socket = /tmp/mysql.sock，但实际文件位于其他路径，需同步修改my.cnf中[client]与[mysqld]段的socket参数并重启MySQL。

五、验证用户权限与认证方式

该步骤用于排查因账号权限范围受限或认证插件不兼容引发的连接拒绝。

1、登录MySQL服务端（使用已知可用账号），执行 SELECT user, host FROM mysql.user; 查看目标用户的host字段是否匹配客户端来源IP或主机名。

2、若host为 localhost，则仅允许本机socket连接；如需TCP连接，需执行 UPDATE mysql.user SET host='127.0.0.1' WHERE user='root' AND host='localhost'; FLUSH PRIVILEGES;。

3、对于MySQL 8.0+，若用户使用 caching_sha2_password 插件，而PHP版本较低（如PHP 7.2以下），可能导致握手失败；可临时改为 mysql_native_password：ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'your_password'; FLUSH PRIVILEGES;。

4、检查连接字符串中密码是否含特殊字符，若使用命令行连接，需用单引号包裹密码，例如：mysql -u root -p'P@ssw0rd!'。