unknown mysql server host 错误通常是因为 php 代码中的主机地址配置有误，或者服务器无法解析该域名。解决这个问题的具体做法是检查 $host 变量是否拼写正确，如果是本地开发环境，应将其修改为 127.0.0.1 或 localhost，并确保网络连通性正常。
如何正确配置数据库连接参数
要修复此错误，需要确保传递给 mysqli_connect 函数的第一个参数是有效的 IP 地址或可解析的主机名。在大多数情况下，使用 127.0.0.1 比 localhost 更稳定，因为后者可能尝试通过 Unix socket 连接而非 TCP/IP，从而引发不同的解析问题。
<?php
$host = '127.0.0.1';
$user = 'root';
$password = '';
$dbname = 'test_db';
$conn = new mysqli($host, $user, $password, $dbname);
if ($conn->connect_error) {
die('Connection failed: ' . $conn->connect_error);
}
echo 'Connected successfully';
?>
上述代码中，我们将主机设置为 127.0.0.1，这强制 MySQL 客户端通过 TCP/IP 协议进行连接。如果连接成功，脚本将输出 "Connected successfully"；如果失败，则会抛出包含具体错误信息的异常。这种写法避免了 DNS 解析带来的不确定性。
立即学习“PHP免费学习笔记（深入）”；
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录，或需要将该能力封装成可公开复用的 Codex skill。
为什么 localhost 有时会导致连接失败
当使用 localhost 作为主机名时，MySQL 客户端库可能会优先尝试使用本地套接字文件（Unix Socket）进行连接，而不是建立 TCP 网络连接。如果 PHP 和 MySQL 的套接字路径不匹配，或者服务器未启用本地套接字连接，就会报错。相比之下，127.0.0.1 始终使用 TCP/IP，兼容性更好。
<?php
// 测试 localhost 的行为
$host_local = 'localhost';
$conn_local = @new mysqli($host_local, 'root', '', 'test_db');
if ($conn_local->connect_error) {
echo 'Localhost failed: ' . $conn_local->connect_error;
} else {
echo 'Localhost succeeded';
}
// 测试 127.0.0.1 的行为
$host_ip = '127.0.0.1';
$conn_ip = @new mysqli($host_ip, 'root', '', 'test_db');
if ($conn_ip->connect_error) {
echo 'IP failed: ' . $conn_ip->connect_error;
} else {
echo 'IP succeeded';
}
?>
通过对比测试可以发现，localhost 在某些环境下会因套接字路径问题而失败，而 127.0.0.1 则能稳定建立连接。因此，在生产环境或不确定配置的情况下，推荐使用 IP 地址作为主机名。
连接超时时的排查方法
如果修改主机地址后仍然报错，可能是由于网络延迟或防火墙阻止了连接。此时可以设置连接超时时间，以便更快地识别问题。通过指定 mysqli_connect 的第四个参数 $port 和第五个参数 $socket，可以更精细地控制连接行为。
<?php
$host = '127.0.0.1';
$port = 3306;
$socket = null;
$conn = new mysqli($host, 'root', '', 'test_db', $port, $socket);
$conn->connect_timeout = 5; // 设置超时时间为 5 秒
if ($conn->connect_error) {
die('Timeout or connection error: ' . $conn->connect_error);
}
?>
这段代码显式指定了端口号，并设置了较短的超时时间。如果 MySQL 服务未运行或网络不通，脚本会在 5 秒内快速失败，避免长时间挂起。这有助于区分是主机解析问题还是网络/服务状态问题。
