phpenv不管理MySQL，所有错误码（如1045、2003、1049）均来自MySQL服务端；排查应聚焦MySQL运行状态、用户权限、认证插件、socket路径四点，而非phpenv本身。
phpenv 本身不管理 MySQL，也不会产生 MySQL 错误码；你看到的 1045、2003、1049 等错误，全部来自 MySQL 服务端，和 phpenv 无关。 phpenv 只负责切换 PHP 版本，它不启动、配置或连接 MySQL。一旦 PHP 脚本执行 mysqli_connect() 或 PDO 连接逻辑，错误就由 MySQL 服务器返回——此时排查方向必须离开 phpenv，直奔 MySQL 本身。
为什么在 phpenv 环境下总遇到 MySQL 2003 错误
常见现象是：PHP 脚本报 mysqli_connect(): (HY000/2003): Can't connect to MySQL server，但你在终端用 mysql -u root -p 却能连上。
- 根本原因不是 phpenv，而是 PHP 使用的 socket 路径或 host 解析不一致：当脚本里写
"localhost"，MySQLi 默认走 Unix socket；而命令行用mysql客户端可能读的是/etc/mysql/my.cnf的 socket 配置，PHP 的 mysqli 扩展却读的是编译时硬编码的路径（如/var/run/mysqld/mysqld.sock） - 解决办法不是改 phpenv，而是统一连接方式：把 PHP 中的
"localhost"换成"127.0.0.1"，强制走 TCP，绕过 socket 路径差异 - 或者，在
php.ini中显式指定 socket：mysqli.default_socket = /var/run/mysqld/mysqld.sock（路径需和mysql --socket输出一致）
phpenv 切换 PHP 后，MySQL 连接突然报 1045
错误信息类似：Access denied for user 'root'@'localhost'，但密码没改、用户也没动。
- 真实原因是：不同 PHP 版本（尤其 7.x → 8.x）默认启用的 MySQL 认证插件不同。MySQL 8.0+ 新建用户默认用
caching_sha2_password，而旧版 PHP 的 mysqli 扩展（尤其未更新的 libmysqlclient）不支持该插件 - 验证方式：登录 MySQL 执行
SELECT user, host, plugin FROM mysql.user WHERE user = 'root';，若 plugin 是caching_sha2_password，就是它 - 临时解法（开发环境）：
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password'; FLUSH PRIVILEGES; - 不建议在 phpenv 层面“修复”，因为这是 MySQL 服务端与客户端协议兼容性问题
为什么 phpenv install 后，PHP 脚本查不到数据库（1049 错误）
mysqli_connect(): (HY000/1049): Unknown database 'xxx' —— 这类错误和 phpenv 完全无关，但新手容易误判。
立即学习“PHP免费学习笔记（深入）”；
- 1049 表示 MySQL 服务器上根本不存在那个库名，不是权限、不是连接失败，就是字面意思：库不存在
- 常见诱因：本地开发用 Docker 或 Homebrew 装了多个 MySQL 实例（比如 MAMP 自带一个，系统 brew install 又装一个），脚本连的是 A 实例，而你手动创建库是在 B 实例里
- 确认当前连接目标：
echo $conn->host_info;或在连接后执行SELECT @@port, @@socket; - 不要依赖 phpenv 的“环境干净”假象——它不隔离数据库服务，只隔离 PHP 二进制和扩展
真正要盯住的，永远是 MySQL 的运行状态、用户权限、认证插件、socket 路径这四点。phpenv 只是 PHP 的版本开关，它既不启动 MySQL，也不改 my.cnf，更不会帮你修 GRANT 权限。所有“在 phpenv 下出错”的表象，背后都是 MySQL 服务端配置或客户端协议适配问题。
