mysqli_connect()连不上MySQL通常是配置或权限问题而非代码错误，常见原因包括MySQL未启动、端口变更、用户权限不足、PHP未启用mysqli扩展、localhost与127.0.0.1连接方式差异、SSL配置不匹配、字符集未正确设置及错误信息未开启显示等。
mysqli_connect() 连不上 MySQL 就是配置或权限问题
连不上不是代码写错，大概率是 mysqli_connect() 的参数没对上服务状态。本地开发常见：MySQL 没启动、端口被改过、用户没授权访问目标数据库，或者 PHP 没装 mysqli 扩展。
-
mysqli_connect()第一个参数默认是'localhost'，但很多环境（比如 Docker 或远程服务器）得换成'127.0.0.1'—— 因为localhost会走 Unix socket，而127.0.0.1走 TCP，失败时错误信息常是Connection refused - 检查
phpinfo()页面里有没有mysqli模块，没看到就说明扩展没启用，Linux 下通常要sudo phpenmod mysqli，Windows 则需在php.ini里取消;extension=mysqli前的分号 - 用命令行验证 MySQL 是否可访问：
mysql -u root -p -h 127.0.0.1 -P 3306，能进才说明服务、端口、账号都 OK；如果提示Access denied，重点查用户权限，尤其是 host 是'localhost'还是'%'
mysqli_real_connect() 和 mysqli_connect() 本质一样，但更可控
mysqli_real_connect() 是面向对象风格的底层连接方式，和过程式 mysqli_connect() 功能完全一致，只是把参数拆开传、支持复用连接对象。日常开发用哪个都行，但调试时它能让你更早捕获连接前的配置错误。
- 用
mysqli_init()初始化后，必须调用mysqli_options()设置选项（比如MYSQLI_OPT_CONNECT_TIMEOUT），否则超时等行为可能不符合预期 - 如果设置了
MYSQLI_CLIENT_SSL，但 MySQL 服务没配 SSL，连接会静默失败，错误信息可能是空或SSL connection error，此时应先关掉 SSL 尝试 - 连接成功后，务必用
mysqli_connect_errno()或$mysqli->connect_errno检查返回值，不能只靠if ($conn)—— 某些网络抖动下连接对象存在但实际不可用
mysqli_set_charset() 必须在连接后立刻调用
中文乱码不是数据库字符集设错了，而是 PHP 连接层没告诉 MySQL “我要用 utf8mb4”。即使表和字段都是 utf8mb4_unicode_ci，只要连接时没设置字符集，INSERT 或 SELECT 都可能出问题。
- 必须在
mysqli_connect()或mysqli_real_connect()成功之后、执行任何 SQL 之前调用mysqli_set_charset($conn, 'utf8mb4')；放在后面等于白设 - 不要用
SET NAMES utf8mb4替代，它不保证后续所有操作都生效，尤其在预处理语句中容易失效 - 如果用的是 PDO，对应的是
PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4"，但 mysqli 没这个机制，只能靠mysqli_set_charset()
连接失败时的错误信息往往藏在 mysqli_connect_error() 里
很多人只看浏览器空白页或 500 错误，却没打开 PHP 错误报告，导致根本看不到 mysqli_connect_error() 返回的具体内容。没有错误信息，就等于蒙眼修车。
立即学习“PHP免费学习笔记（深入）”；
- 开发阶段务必确保
display_errors = On且error_reporting = E_ALL在php.ini中启用，否则mysqli_connect_error()的输出会被吞掉 - 错误信息里出现
Host 'xxx' is not allowed to connect，说明 MySQL 用户权限限制了来源 IP，要用GRANT ... ON *.* TO 'user'@'%' IDENTIFIED BY 'pass'; FLUSH PRIVILEGES;放宽（生产环境慎用'%'） - 出现
Too many connections不代表代码漏关连接，而是 MySQL 的max_connections设太小，或者连接池没复用、短连接高频创建，得查SHOW STATUS LIKE 'Threads_connected';
真正麻烦的不是连不上，而是连上了却因为字符集、超时、SSL 或权限细节没对齐，让查询结果看起来“偶尔出错”——这种问题最难定位，也最容易被当成业务逻辑 bug 去瞎调。
