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 都可能出问题。
1.) 将所有文件解压到php环境中,本程序才用smarty+php+mysql设计。如果运行不了,请修改hhy文件夹下的smarty.php文件改法请看说明2.) 修改configs下的config.inc.php下的连接数据库的密码和用户名3.) 本程序没有做安全页面,人工导入sql.inc到mysql数据库。管理员初始化帐号为admin,密码为hhy。后台地址:http://你的网站地址/h
- 必须在
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 去瞎调。










