MySQL错误码 2003 分析与解决方案

'pdo_code' => 'HY000',
'db_code' => 2003,
'db_error' => 'Can\'t connect to MySQL server on \'host\' (10061)'

// 基本TCP/IP连接配置
$host = 'localhost'; // 或具体的IP地址
$port = 3306;
$dbname = 'your_database';
$charset = 'utf8mb4';

$dsn = "mysql:host={$host};port={$port};dbname={$dbname};charset={$charset}";
$options = [
  PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
  PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
  PDO::ATTR_EMULATE_PREPARES => false,
  PDO::ATTR_TIMEOUT => 30, // 连接超时时间（秒）
  PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4"
];

try {
  $pdo = new PDO($dsn, 'username', 'password', $options);
  echo "连接成功！";
} catch (PDOException $e) {
  echo "连接失败: " . $e->getMessage();
  // 检查错误码是否为2003
  if ($e->getCode() == '2003') {
    // 网络连接问题，尝试诊断
    echo "
网络连接问题，请检查：";
    echo "
- MySQL服务是否运行";
    echo "
- 防火墙设置";
    echo "
- 主机名解析";
    echo "
- 端口是否开放";
  }
}

# Linux/Mac
systemctl status mysql
# 或
service mysql status
# 启动服务
systemctl start mysql

# Windows
net start mysql

# 测试端口连通性
telnet 服务器IP 3306
# 或
nc -zv 服务器IP 3306

# 检查DNS解析
nslookup mysql-server-hostname
# 或
ping mysql-server-hostname

# Linux 防火墙检查
ufw status
# 或
iptables -L -n

# 开放MySQL端口
ufw allow 3306/tcp
# 或
iptables -A INPUT -p tcp --dport 3306 -j ACCEPT

# 查看MySQL绑定地址
SHOW VARIABLES LIKE 'bind_address';

# 查看最大连接数
SHOW VARIABLES LIKE 'max_connections';

# 查看当前连接数
SHOW STATUS LIKE 'Threads_connected';

# 查看端口监听状态
netstat -tuln | grep 3306
# 或
ss -tuln | grep 3306

# 查看连接追踪
netstat -an | grep :3306
# 或
lsof -i :3306