XAMPP 默认 MySQL 端口 3306 冲突时的修改与映射方法-php教程-PHP中文网

确认端口冲突需先查mysql错误日志：出现“bind on tcp/ip port”才是3306被占，否则是配置错误；改my.ini的[mysqld]段port=3307并保存为utf-8无bom；同步更新phpmyadmin config.inc.php和php代码中的连接地址为127.0.0.1:3307。

xampp 默认 mysql 端口 3306 冲突时的修改与映射方法

确认是 3306 被占用，而不是 MySQL 没启动

很多人改完配置就重启 XAMPP，发现 mysqld 还是启动失败，其实根本没走到端口读取那步——mysqld 因权限、数据目录损坏或 my.ini 语法错误直接退出了。先打开 XAMPP 控制面板，点击 mysql 行的 Logs 按钮，看最后一段错误是否含 Can't start server: Bind on TCP/IP port。只有出现这句，才是真端口冲突；如果看到 unknown variable 或 innodb_data_file_path 相关报错，得先修配置文件本身。

修改 MySQL 的监听端口（Windows 下改 `my.ini`）

XAMPP 的 MySQL 配置文件默认在 C:\xampp\mysql\bin\my.ini（不是 etc 目录下的同名文件）。用记事本或 VS Code 打开它，在 [mysqld] 段落下添加或修改这一行：

port=3307

注意：port 必须写在 [mysqld] 下，写在 [client] 或文件末尾无效；改完必须保存为 UTF-8 无 BOM 格式，否则 MySQL 启动时可能静默失败；改完后重启 XAMPP 控制面板里的 MySQL 服务，不要只点 Start，要先 Stop 再 Start。

PHP 和 phpMyAdmin 连接不到新端口？改这两个地方

只改 MySQL 端口，phpMyAdmin 和你写的 PHP mysqli_connect() 还会连 3306，导致“连接被拒绝”。需要同步调整：

C:\xampp\phpMyAdmin\config.inc.php 中找 $cfg['Servers'][$i]['host']，改成 '127.0.0.1:3307'（不能写 localhost:3307，Windows 下 localhost 会走命名管道，绕过端口）
PHP 代码里所有 mysqli_connect('localhost', ...) 改成 mysqli_connect('127.0.0.1', ..., ..., ..., 3307)，第 5 个参数传端口号（或者用 DSN 形式：mysql:host=127.0.0.1;port=3307）

Apache 不需要额外配置，它不直连 MySQL；但如果你用了 PDO，DSN 字符串里必须显式带 port=3307，光靠 default_socket_timeout 搞不定。

Docker 或其他本地服务也在占 3306？查清再动手

常见干扰源：Docker Desktop 自带的 MySQL 容器、WAMP/Laragon 残留服务、甚至某些国产软件（如腾讯电脑管家“数据库防护”模块）。别急着改 XAMPP，先运行命令：

netstat -ano | findstr :3306

看 PID 对应什么进程（用任务管理器“详细信息”页查 PID），再决定是停掉对方，还是给 XAMPP 换端口。硬塞一个冷门端口（比如 33066）不如让 Docker 容器映射到 3307，避免后续开发环境不一致。另外，Windows 10/11 的 Hyper-V 有时会偷偷占 3306，关掉“Windows 功能”里的“Windows Subsystem for Linux”和“Virtual Machine Platform”可能释放端口。

端口改完能连上，不代表万事大吉——有些老项目硬编码了 3306 在 SQL 文件、部署脚本或 CI 配置里，这些地方漏掉一个，上线前测试就崩。建议把新端口写进团队文档，顺便 grep 一遍项目代码库里的 :3306 和 3306 字符串。