MySQL启动失败的直接原因是3306端口被其他进程占用,导致无法绑定;常见抢占者包括另一MySQL实例、MariaDB、Docker容器或IDE等,需用lsof/netstat查PID并确认进程名,再针对性处理。

MySQL 启动失败,netstat -tlnp | grep 3306 显示端口被占用
直接原因就是 3306 端口正被另一个进程监听,MySQL 无法绑定。phpEnv 默认走 TCP/IP,所以它不会尝试 Unix socket,而是死磕 127.0.0.1:3306。
先确认谁在抢端口:
- Linux/macOS:
sudo lsof -i :3306或sudo netstat -tulpn | grep :3306 - Windows:
netstat -ano | findstr :3306,再用tasklist | findstr "PID"查进程名
常见抢占者:另一个 MySQL 实例、MariaDB、Docker 容器、甚至某些 IDE(如 PHPStorm 的数据库工具)或本地开发环境(如 XAMPP/WAMP 的残留服务)。别急着 kill,先看是不是你主动启的其他服务。
my.cnf 中 bind-address 设为 127.0.0.1 却连不上
这不矛盾——bind-address=127.0.0.1 表示 MySQL 只监听本机回环接口,但前提是端口空闲且没被防火墙/SELinux 拦截。如果它启动失败,日志里通常有类似 Can't start server: Bind on TCP/IP port: Address already in use 的提示。
立即学习“PHP免费学习笔记(深入)”;
检查点:
-
mysqld --verbose --help | grep "Default options"确认 phpEnv 实际读取的是哪个my.cnf(常为/path/to/phpenv/etc/my.cnf) - 配置中不能同时存在
bind-address = 0.0.0.0和skip-networking,后者会直接禁用 TCP 连接 - 若用 Docker 运行 phpEnv,宿主机的
3306被占,容器内 MySQL 仍可能启动成功(它用的是容器网络),但宿主机访问不到
root 用户能连 localhost,但连 127.0.0.1 报 Access denied
这是权限粒度问题:localhost 触发 Unix socket 认证(依赖 auth_socket 插件),而 127.0.0.1 强制走 TCP,查的是 'root'@'127.0.0.1' 这条记录,不是 'root'@'localhost'。
解决方法(进 MySQL 执行):
- 确认用户存在:
SELECT Host, User, plugin FROM mysql.user WHERE User = 'root'; - 若缺
'root'@'127.0.0.1',补一条:CREATE USER 'root'@'127.0.0.1' IDENTIFIED WITH mysql_native_password BY 'your_password'; - 赋权:
GRANT ALL PRIVILEGES ON *.* TO 'root'@'127.0.0.1' WITH GRANT OPTION; - 刷新:
FLUSH PRIVILEGES;
注意:MySQL 8+ 默认插件是 caching_sha2_password,很多旧客户端不兼容,强制切到 mysql_native_password 更稳。
phpEnv 启动脚本里硬编码了 127.0.0.1,但你想换端口
phpEnv 自带的 MySQL 启动逻辑(比如 phpenv mysql:start)通常不暴露端口配置入口。真要改,得动两处:
- 修改其加载的
my.cnf,在[mysqld]下加:port = 3307 - 找到 phpEnv 的 MySQL service 脚本(路径类似
~/.phpenv/plugins/mysql/bin/mysql-start),把里面所有写死的3306替成新端口
改完必须重启整个 phpEnv MySQL 服务,且所有连接它的 PHP 项目(如 mysqli_connect('127.0.0.1', 'root', 'pw', '', 3307))也得同步改端口参数——漏一处就连不上。
socket 文件路径、plugin 类型、host 权限粒度,这三处最容易被忽略。它们不报错,但会让连接行为完全不符合直觉。



















