mysqli_connect()失败时默认静默返回false，必须显式判断并调用mysqli_connect_error()获取具体原因，如Connection refused、Access denied或Unknown host等。
检查 mysqli_connect() 返回值是否为 false
PHP 8.0 中，mysqli_connect() 在失败时不再抛出警告（默认关闭了 E_WARNING 显示），而是静默返回 false。如果只靠页面空白或无报错就断定“连不上”，大概率是漏看了返回值判断。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 必须显式检查连接结果：
if (!$conn) { echo mysqli_connect_error(); exit; } - 不要依赖
@mysqli_connect()抑制错误——它同时屏蔽了调试信息 - 确保
display_errors = On且error_reporting = E_ALL在开发环境生效（可通过phpinfo()确认）
确认 MySQLi 扩展已启用且兼容 PHP 8.0
PHP 8.0 移除了对旧版 MySQL 扩展（mysql_*）的支持，仅保留 mysqli 和 PDO_MySQL。若配置仍沿用废弃扩展或扩展未加载，连接会直接失败而非报具体错误。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 运行
php -m | grep mysqli（CLI）或查看phpinfo()页面中 “mysqli” 模块是否存在 - 检查
php.ini是否启用了extension=mysqli（Windows 下可能是extension=php_mysqli.dll） - 注意：某些 Docker 镜像或一键包（如 AMPPS）可能默认禁用 mysqli，需手动开启
验证连接参数是否含不可见字符或类型错误
PHP 8.0 对类型更严格，比如把整数端口写成字符串 "3306" 通常没问题，但若混入 BOM 或全角空格（尤其从配置文件、环境变量读取时），mysqli_connect() 会静默失败。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
var_dump(bin2hex($host));检查主机名变量是否含隐藏字节 - 避免从
.env文件直接赋值后不 trim：$port = trim($_ENV['DB_PORT'] ?? '3306'); - 测试时改用硬编码参数绕过配置层，例如：
mysqli_connect('127.0.0.1', 'root', '', 'test', 3306)
排查 MySQL 服务本身拒绝连接的常见原因
连接失败不一定是 PHP 代码问题。PHP 8.0 的错误提示比旧版本更“干净”，反而掩盖了底层网络或权限问题。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用命令行验证：执行
mysql -h 127.0.0.1 -P 3306 -u root -p，看是否能登录——排除 MySQL 服务未启动、bind-address 限制、用户权限不足 - 注意 PHP 连接用的是 TCP 还是 socket：
127.0.0.1强制走 TCP，localhost在 Linux 下可能走 socket，行为不一致 - 检查 MySQL 错误日志（通常是
/var/log/mysql/error.log或mysqld.err），里面常有“Access denied for user”或“Connection refused”详情
