connection refused 错误主因是 mysql 服务未运行或端口/地址配置异常；应先验证服务状态、检查 bind-address、改用 127.0.0.1 替代 localhost，并确认 mysqli 或 pdo 扩展已启用。
mysqli_connect() 连不上，错误提示 Connection refused
不是代码写错了，大概率是 MySQL 服务根本没在跑，或者端口被改过。php 默认用 3306 连本地 MySQL，但 docker、MAMP、XAMPP 或某些云数据库会换端口或绑定地址。
- 先终端执行
mysql -u root -p，能连上说明服务正常；连不上就先启服务：sudo service mysql start（linux）或检查 MAMP/XAMPP 面板 - 确认 MySQL 绑定地址：查
/etc/mysql/mysql.conf.d/mysqld.cnf（Linux）或my.ini（windows），看bind-address是不是127.0.0.1或localhost—— 如果是0.0.0.0或注释掉，才支持外部连接 -
mysqli_connect()第一个参数别硬写"localhost"，它在某些系统（尤其 macos）会走 socket 而非 TCP，换成"127.0.0.1"更稳
用 mysqli 还是 PDO？选哪个更实际
不是“哪个更好”，是“你当前项目卡在哪”。PDO 支持预处理、多数据库切换，但如果你只用 MySQL 且不打算换库，mysqli 的面向对象写法够用、报错更直白、扩展不用额外开（PHP 默认带 mysqli，PDO_mysql 有时要手动启用）。
- 检查是否启用：
php -m | grep -i mysqli（命令行）或var_dump(extension_loaded('mysqli'));（PHP 脚本） - 如果要用 PDO，确保
extension=pdo_mysql在php.ini里没被注释，然后重启 Web 服务 - 别为了“看起来高级”强行上 PDO——比如只是写个后台登录表单，
mysqli_real_escape_string()+ 手动拼 SQL（不推荐）不如直接用mysqli_prepare()，这时候mysqli的预处理 API 更轻量
mysqli_connect() 成功但查不出数据，mysqli_fetch_array() 返回空
连接成功 ≠ 查询成功。常见原因是没执行查询，或者结果集为空后还反复 fetch。
- 必须检查
mysqli_query()返回值：$result = mysqli_query($conn, $sql); if (!$result) { die(mysqli_error($conn)); } -
mysqli_fetch_array()是游标式读取，每调一次移一位，第一次就返回NULL？可能是 SQL 语法错（比如字段名写错）、WHERE 条件太严、表里真没数据，先用 phpMyAdmin 或命令行直接跑那条 SQL 看结果 - 如果想取全部行，别写
while ($row = mysqli_fetch_array($result))就完事——得确认$result是有效结果集（is_object($result)），否则mysqli_fetch_array()会警告并返回null
密码含特殊字符（如 @、/、:）导致连接失败
不是 PHP 解析错，是 URL 形式连接（比如用 PDO 的 DSN）时，@ 和 / 会被当分隔符解析。mysqli 函数式连接（mysqli_connect($host, $user, $pass)）不受影响，但很多人抄示例用了 PDO DSN 写法。
立即学习“PHP免费学习笔记（深入）”；
- PDO DSN 示例：
mysql:host=localhost;dbname=test—— 密码里的@必须 URL 编码：rawurlencode('p@ss/w0rd')→p%40ss%2Fw0rd - mysqli 不需要编码，但注意：如果密码开头是数字或含空格，用变量传参比直接写字符串更安全，避免引号混淆
- 开发环境别用明文密码硬编码，至少从
.env文件读，或用 PHP 8.1+ 的$_SERVER['MYSQL_PASSWORD']（配合 Web 服务器环境变量注入）
事情说清了就结束。真正卡住的往往不是函数怎么写，而是 MySQL 服务状态、用户权限（GRANT select ON test.* TO 'user'@'localhost'）、甚至 SELinux 或防火墙拦了本地端口——连之前，先用 telnet 127.0.0.1 3306 确认端口通不通。