XAMPP报错"mysqli_connect(): Connection refused":检查MySQL主机名、端口与套接字配置

浅萱吖_9500

浅萱吖_9500

2026-06-14

263人浏览

原创

connection refused错误表明php根本未触达mysql进程,主因是mysql未监听指定地址端口组合;需先验证mysql -h 127.0.0.1 -p 3306 -u root -p是否可登录,xampp中应改localhost为127.0.0.1强制tcp连接,并检查my.ini端口与bind-address配置及端口占用。

xampp报错\

mysqli_connect() 报 Connection refused,先别改 PHP 代码

这不是 PHP 写错了,是请求压根没触达 MySQL 进程。90% 的情况是 MySQL 没监听你写的那个地址+端口组合。XAMPP 默认用 3306,但实际可能被占、被改、或根本没启动。

  • 先在命令行跑:mysql -h 127.0.0.1 -P 3306 -u root -p —— 能进命令行,说明服务在跑且端口通;进不去就停在这里排查
  • Windows 下打开 XAMPP 控制面板,确认 MySQL 行状态是绿色“Running”,不是灰色或红色
  • 如果控制面板显示 MySQL 启动失败,直接看 xampp\mysql\data\mysql_error.log,比猜快得多

localhost 和 127.0.0.1 在 XAMPP 里行为完全不同

PHP 用 localhost 会走 Unix socket(Windows 上是命名管道),而 XAMPP for Windows 默认不启用 socket 通信,只监听 TCP。结果就是:写 localhost → 连 socket → 失败 → 报 Connection refused。

MySQL
MySQL

编写正确的MySQL查询,避免字符集、索引和锁方面的常见陷阱。

下载
  • 强制走 TCP:把 mysqli_connect('localhost', ...) 改成 mysqli_connect('127.0.0.1', ...)
  • 不要依赖 DNS 解析:避免写 mysqli_connect('myserver.local', ...),本地开发一律用 127.0.0.1
  • phpMyAdmin 配置也要同步改:检查 xampp\phpMyAdmin\config.inc.php 里的 $cfg['Servers'][$i]['host'] 是否为 '127.0.0.1'

XAMPP 的 my.ini 可能被悄悄改过

XAMPP 自带的 my.ini 一旦被手动编辑出错(比如多了一个空格、少了括号、端口写成字符串),MySQL 就会静默启动失败——控制面板仍显示“Running”,但实际进程已退出。

  • 路径一般是:xampp\mysql\bin\my.ini(不是 etc\ 下那个)
  • 重点核对两行:port=3306(不能带引号,不能是 port = "3306")和 bind-address=127.0.0.1(不是 localhost)
  • 如果改过配置,必须重启整个 XAMPP 控制面板,只点“Stop”再“Start” MySQL 不生效
  • 临时验证:把 my.ini 重命名为 my.ini.bak,再启动 MySQL —— 如果成功,说明原配置有问题

端口冲突是 XAMPP 最常见的硬伤

Skype、另一套 XAMPP、MariaDB、甚至某些国产软件会抢 3306。XAMPP 启动时发现端口被占,不会报错,而是直接放弃监听 —— 所以你看到服务“运行中”,其实是假象。

  • Windows 管理员命令行执行:netstat -ano | findstr :3306,看 PID 是谁占的
  • 查进程名:tasklist | findstr "PID号"(把 PID号 替换成上一步结果)
  • 杀掉它:taskkill /F /PID PID号;或者改 XAMPP 端口:在 my.ini 里把 port=3306 改成 port=3307,然后 PHP 连接时必须显式传第 5 个参数:mysqli_connect('127.0.0.1', 'root', '', 'test', 3307)
真实问题往往卡在“以为服务起来了”,其实 MySQL 进程早崩了;或者以为改了 host 就够,却忽略了 port 参数漏传或位置错位。XAMPP 的便利性掩盖了底层 TCP 绑定细节,越想绕开这些细节,越容易卡在 Connection refused 里。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

10604

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

6221

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2135

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

3928

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4634

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3631

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

5197

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

4062

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

12002

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程