mysqli_connect() 返回 false 时必须立即调用 mysqli_connect_error() 获取具体错误，常见原因包括 Connection refused（服务未运行）、Access denied（用户 host 不匹配）和 Unknown host（主机名错误），同时需确保 mysqli 扩展已启用、host 仅写地址不带库名、连接后显式设置 utf8mb4 字符集。
PHP 8.5.5 本身不决定怎么连数据库，它只是运行环境；真正要调的是 mysqli 扩展的用法——本地连接失败，90% 是参数顺序、host 写法或字符集漏设导致的。
mysqli_connect() 的四个参数必须按顺序传，不能少也不能错位
本地连接最常踩的坑是把数据库名塞进 host 字符串里，比如写成 "localhost/testdb"。这是错的，mysqli_connect() 严格要求前四个参数分别是：$host、$username、$password、$database。
-
$host只能是地址（"localhost"、"127.0.0.1"或域名），不能带库名、端口或路径 - 端口非默认 3306 时，
$host仍写"127.0.0.1"，第 5 个参数传$port（如3307） - Unix socket 连接（如 MAMP/XAMPP）才用第 6 个参数
$socket，一般开发环境不用碰 - 密码含
@、/等符号？不用 URL 编码，mysqli_connect()不解析 URL
连接成功后必须立刻设 charset=utf8mb4，不能靠 DSN 或 SET NAMES 代替
mysqli_connect() 返回连接对象后，必须紧接着调用 set_charset('utf8mb4')。只在 MySQL 配置里设 default-character-set 没用，只执行 query("SET NAMES utf8mb4") 也不保险——某些字段（比如 JSON、ENUM）仍可能乱码或截断。
- 正确写法：
$conn->set_charset('utf8mb4'); - 错误写法：
$conn->query("SET NAMES utf8mb4");（兼容性差，尤其 PHP 8.5+ + MySQL 8.0+） - 如果用过程式风格，对应函数是
mysqli_set_charset($conn, 'utf8mb4') - 没设 charset，存 emoji 或中文会变
???或直接报Incorrect string value
连不上先看 mysqli_connect_error()，别猜密码或权限
报 Connection refused 或空白页？不是密码错了，而是 MySQL 根本没响应。优先检查三件事：
立即学习“PHP免费学习笔记（深入）”；
- MySQL 服务是否真在跑：
sudo systemctl status mysql（Linux）或任务管理器里找mysqld进程（Windows） - MySQL 是否监听
127.0.0.1：查配置文件（如/etc/mysql/mysql.conf.d/mysqld.cnf）中bind-address是不是127.0.0.1或0.0.0.0 - 用户授权是否匹配：本地连接要用
'user'@'localhost'，不是'user'@'%'；后者在部分系统下走 socket，mysqli_connect()强制走 TCP 就会失败 - PHP 和 MySQL 版本冲突？MySQL 8.0+ 默认用
caching_sha2_password插件，老版 mysqli 不认，得在 MySQL 里执行：ALTER USER 'your_user'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_pass';
面向对象写法比过程式更稳，且必须检查 connect_error
过程式写法容易漏判连接失败，导致后续所有 mysqli_query() 调用静默返回 false。面向对象方式能明确暴露问题：
$conn = new mysqli($host, $user, $pass, $db, $port);
if ($conn->connect_error) {
die('连接失败: ' . $conn->connect_errno . ' – ' . $conn->connect_error);
}
$conn->set_charset('utf8mb4');
-
$conn->connect_error是属性，不是方法，别加括号 -
$conn->connect_errno给出错误编号，比纯文字提示更容易定位（比如 2002=连接被拒，1045=权限拒绝） - 不要用
@mysqli_connect()抑制警告——这会让错误彻底消失，调试时无从下手 - 如果项目已用 PDO，别为“统一”硬切 mysqli；混用反而增加维护成本
本地连接看着简单，但 host 写法、charset 设置、错误检查这三点一旦漏掉任意一个，就会卡在“连不上”或“存不对”，而且现象隐蔽。最稳的做法：固定用面向对象 + 显式 set_charset() + 死磕 connect_error 输出。其他都是锦上添花。
