使用PDO SSL连接Azure MySQL数据库报错SQLSTATE[HY000][2002]求助

我来帮你一步步排查这个PDO连接Azure MySQL的问题，报错SQLSTATE[HY000] [2002]通常是连接层面的故障，咱们从几个关键点入手：

1. 修正PDO连接的参数格式 #

你当前的配置里把$port放在了选项数组里，这是错误的——端口应该写在PDO的DSN字符串中，而不是SSL选项里。正确的完整连接代码应该是这样的：

// 替换成你的服务器信息
$host = "your-server-name.mysql.database.azure.com";
$dbname = "your-database-name";
$username = "your-username@your-server-name";
$password = "your-password";
$port = 3306;
$certPath = "/path/to/BaltimoreCyberTrustRoot.crt.pem"; // 注意去掉多余的.txt后缀

$dsn = "mysql:host=$host;dbname=$dbname;port=$port;charset=utf8mb4";
$options = [
    PDO::MYSQL_ATTR_SSL_CA => $certPath,
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION // 开启异常模式方便排查
];

try {
    $pdo = new PDO($dsn, $username, $password, $options);
    echo "连接成功！";
} catch(PDOException $e) {
    die("连接失败: " . $e->getMessage());
}

注意：Azure MySQL的用户名格式是用户名@服务器名，别漏了@后面的服务器前缀。另外你的证书文件名多了.txt后缀，建议改成官方的BaltimoreCyberTrustRoot.crt.pem，避免路径识别问题。

2. 排查2002错误的核心原因 #

2002错误本质是无法连接到MySQL服务器，常见原因包括：

• 防火墙规则限制：登录Azure门户，找到你的MySQL服务器，进入「连接安全性」页面，检查防火墙规则是否添加了当前客户端的IP地址，或者临时开启「允许访问Azure服务」（仅测试用，生产环境要严格限制IP）。
• 服务器地址/端口错误：确认$host是完整的Azure MySQL域名（格式为xxx.mysql.database.azure.com），端口默认是3306，检查本地网络是否允许出站3306端口。
• SSL强制验证问题：Azure MySQL默认强制SSL连接，如果你的PHP环境无法验证证书，可以临时添加PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT => false到选项数组中（测试用，生产环境建议保持验证）。

3. 验证证书与网络连通性 #

可以用命令行先测试SSL连接是否正常，排除PHP代码外的问题：

openssl s_client -connect your-server-name.mysql.database.azure.com:3306 -CAfile /path/to/BaltimoreCyberTrustRoot.crt.pem

如果能成功建立连接，说明网络和证书没问题，问题出在PHP代码或环境配置上；如果失败，检查证书路径、服务器地址或防火墙。

4. 检查PHP环境配置 #

确保你的PHP环境已经安装并启用了pdo_mysql扩展，且支持SSL。可以创建一个phpinfo.php文件，内容为<?php phpinfo(); ?>，访问后查找「PDO MySQL」部分，确认SSL support是否为enabled。

内容的提问来源于stack exchange，提问作者mikayiri